/** * This Document is a copyrighted document (2005) and made by Juuso Hukkanen and Markku Sukanen. * Fair usage of the provided text (function names and their descriptions) is allowed within * material that is lisensed using the Charity Open Source License (ChOS) version 2005 or * later. All other copying, considering even partial copying is strictly prohibited * * t3d programming language and the structure of t3d function prototype are trademarks of Juuso Hukkanen. */ t3d_remove_barray_Rbarray_BYTE_n_FIRST t3d_remove_barray_Rbarray_FIRST_n_BYTE t3d_remove_Rbarray_BYTE_n_FIRST t3d_remove_Rbarray_FIRST_n_BYTE DESC: Removes first byte from a byte-array. RET: 1 if successful, -1 if fails. t3d_read_barray_Rbarray_COPY_n_FROM_OFFSETXXX_BYTESXXX t3d_write_barray_Rbarray_COPY_n_FROM_OFFSETXXX_BYTESXXX t3d_write_barray_Rbarray_FROM_OFFSETXXX_BYTESXXX t3d_convert_barray_Rbarray_REVERSE_n_ELEMENTS t3d_write_barray_barray_Rbarray_SAME_n_ELEMENTS t3d_write_barray_barray_Rbarray_SIMILAR_n_ELEMENTS t3d_measure_barray_barray_Rdouble_SIMILARITY t3d_measure_barray_barray_SIMILARITY t3d_measure_barray_barray_DIFFERENCE t3d_measure_barray_barray_DIFFERENCES_n_NUMBER_OF t3d_mittaa_ttaulu_ttaulu_ERILAISIA_n_LUKUMÄÄRÄ t3d_mittaa_ttaulu_ttaulu_ERILAISIA_n_MONTAKO t3d_convert_barray_Rbarray_CHANGE_n_CASE t3d_convert_barray_Rbarray_CASE_n_CHANGE t3d_convert_barray_Rbarray_CHANGE_CASE DESC: Changes case of each letter in barray, upper <-> lower. t3d_write_barray_Rtable_CHUNKS_SIZEXXX DESC: Splits a barray into chunks of some size (SIZE). t3d_write_barray_barray_Rbarray_JOIN t3d_write_barray_barray_Rbarray_COMBINE t3d_write_barray_barray_Rbarray_ADD t3d_write_barray_barray_Rbarray_APPEND t3d_add_barray_barray_Rbarray DESC: Combines/joins/appends first given array to the end of second input array. RET: Number of bytes in the result barray. t3d_calculate_barray_Rtable_FREQUENCE_n_WORDS_COLUMNXXX_COLUMNXXX DESC: Calculate frequency of each word in barray into a table containing two named columns. The first column will contain the words and the second column the number/frequency of the corresponding word. usage( source, table, "1st_col_name", "2nd_col_name" ) t3d_measure_table_Rtable_WORDS_n_UNIQUE t3d_measure_table_Rtable_WORDS_n_UNIQUE_TABLE1_COLUMNXXX_TABLE2_COLUMNXXX DESC: Reads given table1 column and tries to find words not present in other rows at the same column. The resulting table will contain those words (which didn't find a match) on given column. usage( t1, t2, "xyz", "blyz" ) usage( t1, t2, "xyz" ) t3d_measure_table_Rbarray_WORDS_n_UNIQUE t3d_measure_table_Rbarray_WORDS_n_UNIQUE_TABLE1_COLUMNXXX DESC: Reads given table1 column and tries to find words not present in other rows at the same column. The resulting barray will contain those words separated by 'string separator' ( # ). t3d_write_barray_Rbarray_FROM_OFFSETXXX DESC: Writes the given barray to the result barray, starting from the given byte offset. t3d_write_barray_barray_Rbarray_FROM_OFFSETXXX DESC: Writes the given barray to the second given barray, starting from the given byte offset. t3d_convert_table_Rtable_SORT_n_ASCENDING_TABLE1_COLUMNXXX_TABLE1_COLUMNXXX DESC: Sorts the given table first according to the first given column and then according to the second given column. Results are written into result table. t3d_convert_Rtable_SORT_n_ASCENDING_COLUMNXXX_COLUMNXXX DESC: Sorts the given table first according to the first given column and then according to the second given column. The table is sorted in place. t3d_add_byte_Rbarray_BYTESXXX DESC: Adds given number of identical (given) bytes to end of result barray. t3d_add_byte_barray_Rbarray_BYTESXXX DESC: Copies the given barray to resulting barray and adds the given number (BYTESXXX) of identical (given) bytes to end of the result barray. t3d_remove_Rbarray_BYTE_n_LAST DESC: Removes the last byte from barray... in place. t3d_calculate_iarray_Rlong_PRODUCT DESC: Calculates the product of all integers in the given iarray, resulting number is the product. t3d_calculate_iarray_Rlong_SUM DESC: Calculates the sum of all integers in the given iarray, resulting number is the sum... Obviously. t3d_add_int_Riarray_2END t3d_add_int_Riarray_LAST DESC: Adds an integer to the end of the given iarray. t3d_read_barray_Rbarray_RANDOM_n_WORDS_COUNTXXX DESC: Picks COUNTXXX number of random words from the given barray, and writes them into the result barray. t3d_find_barray_barray_DOES_CONTAIN t3d_find_barray_barray_IS_PRESENT t3d_find_barray_barray_DOES_CONTAIN_n_CASE_SENSITIVE t3d_find_barray_barray_IS_PRESENT_n_CASE_SENSITIVE DESC: Sees if the first array is contained within the second barray. t3d_find_barray_barray_DOES_CONTAIN_n_CASE_INSENSITIVE DESC: Sees if the first array is contained within the second barray, without caring about upper/lower case letters' difference. t3d_write_barray_Rbarray_WORD_n_FIRST t3d_write_barray_Rbarray_FIRST_n_WORD DESC: Writes the first word from the given barray into result barray. t3d_remove_Rbarray_WORD_n_FIRST t3d_remove_Rbarray_FIRST_n_WORD DESC: Removes the first word from the (result) barray. t3d_remove_Rbarray_DUPLICATE_n_WORDS t3d_remove_Rbarray_WORDS_n_DUPLICATE DESC: Removes duplicates of words from barray. t3d_remove_Rtable_DUPLICATE_n_ROWS t3d_remove_Rtable_ROWS_n_DUPLICATE DESC: Removes duplicates of data rows from table. t3d_add_barray_barray_Rbarray_BEGINNING_n_NO_OVERWRITE DESC: Adds the first barray's contents to the beginning of the second barray. The resulting barray's length is sum of the given input barrays' length. t3d_add_barray_Rbarray_BEGINNING_n_NO_OVERWRITE DESC: Adds the input barray's contents to the beginning of the result barray, without overwriting its contents. The resulting barray's length is the sum of the two original barrays' length. ===[c3d_list_of_functions15.xls]=== t3d_add_byte_barray_START_POSITION DESC: Adds the given byte to start of the given barray. t3d_add_byte_barray_APPEND DESC: Appends the given byte to end of the given barray. t3d_add_byte_byte_REPLACE DESC: The first given byte will replace the contents of the second. t3d_add_int_Rfile_APPEND_n_AS_BINARY DESC: Appends an integer to end of the result file. t3d_add_int_Rfile_APPEND_n_AS_TEXT DESC: Appends an integer to end of the result file in human readable text format. t3d_add_int_Rfile_REPLACE_CHARS_n_AS_TEXT_FILEPOSXXX DESC: Replaces chars in a file starting from offset FILEPOSXXX with the given integer's string representation. t3d_add_int_Rbarray_INT2BARRAY DESC: ??? t3d_add_barray_Rfile_APPEND DESC: Appends the given barray to the end of the result file. t3d_add_byte_Rint t3d_add_byte_int_Rint DESC: Write the mathematical sum of the given byte and int into the result int. t3d_add_barray_url DESC: Attempts to send the given barray to the given url which should be opened earlier using eg. t3d_open_barray_Rurl. t3d_add_Rfile_COLOR_n_RED_PERCENTXXX t3d_add_Rfile_COLOR_n_GREEN_PERCENTXXX t3d_add_Rfile_COLOR_n_BLUE_PERCENTXXX t3d_remove_... DESC: Increase/decrease intensity of red/green/blue gun value by PERCENTXXX% in the given result file. t3d_add_Rfile_COLOR_n_ALPHA_PERCENTXXX t3d_remove_... DESC: Increase/decrease alpha opacity of the result file by PERCENTXXX%. Q: Image types without an alpha channel remain untouched(?). t3d_add_Rfile_CONTRAST_PERCENTXXX t3d_remove_... DESC: Increase/decrease color contrast of the result file by PERCENTXXX%. t3d_add_Rfile_BRIGHTNESS_PERCENTXXX t3d_remove_... DESC: Increase/decrease brightness of the result file by PERCENTXXX%. t3d_add_Rfile_HIGHLIGHT_PERCENTXXX t3d_remove_... DESC: Increase/decrease highlight/midtone/shadow intensity of the result file by PERCENTXXX%. t3d_add_Rfile_HUE_PERCENTXXX t3d_add_Rfile_SATURATION_PERCENTXXX t3d_add_Rfile_LIGHTNESS_PERCENTXXX t3d_remove_.... DESC: Change (add to/subtract from) hue/saturation/lightness of the result file by PERCENTXXX%. Q: This is CMYK / RGB? t3d_convert_Rfile_COLOR_n_NUMBER_OF_BITXXX DESC: Convert the result image file's color format to BITXXX bits. If the number of bits is less than 16 then a default palette is applied to the result image file. t3d_convert_Rfile_2GRAYSCALE DESC: Convert the result image file into grayscale. t3d_convert_Rfile_COLOR_n_NUMBER_OF_COLORSXXX DESC: Convert the result image file's file format to such which allows the given number of colors. t3d_add_Rfile_IMAGE_SIZE_XXXX_YXXX t3d_convert_Rfile_IMAGE_SIZE_XXXX_YXXX DESC: Convert (shrink or enlarge) the result file's image to size of XXXX x YXXX pixels. t3d_add_Rfile_BORDER_WIDTHXXX_COLORXXX t3d_add_Rfile_BORDER_WIDTHXXX_HEIGHTXXX_COLORXXX DESC: Add a border of WIDTHXXX pixels wide (and HEIGHTXXX pixels high, if given) around the result image file using COLORXXX for it. t3d_add_Rfile_BUTTONIZE_WIDTHXXX t3d_add_Rfile_BUTTONIZE_WIDTHXXX_HEIGHTXXX DESC: "Buttonize" the result image file, adding a 3D-like button effect around it which width is WIDTHXXX pixels (and possibly different height of HEIGHTXXX pixels). t3d_add_Rfile_BLUR t3d_add_Rfile_BLUR_n_MORE DESC: Add some (or more) blur to the result file. Q: How much blur? Relative to image size...? t3d_add_Rfile_MOTION_BLUR_ANGLEXXX DESC: Add motion blur to the result image file. Angle 0° is horizontal, pointing toward right; angle 90° is vertical, pointing up - meaning that the angle increases counter-clockwise. Angle 270° is vertical pointing downward. t3d_add_Rfile_EDGE_n_ENHANCE t3d_add_Rfile_EDGE_n_ENHANCE_MORE DESC: Enhance edges (more or less) in the result file. Q: How much are the edges actually enhanced? t3d_add_Rfile_RANDOM_NOISE_PERCENTXXX t3d_add_Rfile_RANDOM_NOISE_n_GRAYSCALE DESC: Adds random "noise" (or "white noise") to the result file, which may be either image or audio file (adding "noise" is possible for any file type, but for anything else but image/audio it's rather useless... usually). Image noise means randomly inserted pixels. 1) By default the noise has maximally as many colors as the result image file's format allows. 2) In the second form the inserted noise is grayscale pixels. t3d_add_Rfile_SHARPEN_IMAGE t3d_add_Rfile_SHARPEN_IMAGE_n_MORE DESC: Sharpen the result file's image (more or less). t3d_add_Rfile_HOT_WAX DESC: Add "hot wax" effect onto result file. t3d_add_Rfile_EMBOSS DESC: Apply some emboss effect into the result image file. t3d_add_Rfile_MOSAIC_BLOCKSIZEXXX DESC: Apply some mosaic effect into the result image file with block size of BLOCKSIZEXXX pixels. t3d_add_barray_Rfile_TEXT2IMAGE DESC: Adds text (the given barray) onto the result image file with standard font (Times New Roman?), adjusting the text size and position so that it will fit into the horizontal width of the result image file. t3d_add_barray_Rfile_TEXT2IMAGE_FONTCOLORXXX DESC: Adds text (the given barray) onto the result file image with given color (FONTCOLORXXX, which is 32-bit RGBA(?)). See more above. t3d_add_barray_Rfile_TEXT2IMAGE_FONTSIZEXXX DESC: Adds text (the given barray) onto the result file image using the defined font size. See more above. t3d_add_barray_Rfile_TEXT2IMAGE_POSXXXX_POSYXXX DESC: Adds text (the given barray) onto the result file image at XY-coords POSXXXX/POSYXXX. See more above, again. t3d_array_barray_Rfile_TEXT2IMAGE_POSXXXX_POSYXXX_FONTXXX_FONTSIZEXXX DESC: Adds text onto the result file image at XY-coords POSXXXX/POSYXXX, using font FONTXXX which size is FONTSIZEXXX. See more above, once again. t3d_array_barray_Rfile_TEXT2IMAGE_POSXXXX_POSYXXX_FONTXXX_FONTSIZEXXX_FONTCOLORXXX DESC: Adds text onto the result file at XY-coords POSXXXX/POSYXXX, using font FONTXXX which size is FONTSIZEXXX and color FONTCOLORXXX (32-bit RGBA?). t3d_add_file_Rfile_MORPH_n_IMAGES t3d_add_file_file_Rfile_MORPH_n_IMAGES DESC: Apply morphing between the given file and result file, the final result written to the result file. Amount of the colors in the morph images will adjust towards the result image file's color depth. t3d_add_file_Rfile_MORPH_n_IMAGES_PERCENTXXX DESC: As per t3d_add_file_Rfile_MORPH_n_IMAGES and t3d_add_file_file_Rfile_MORPH_n_IMAGES but morphing of the result file isn't full--instead it's left at PERCENTXXX% from full composite. t3d_add_file_Rfile_MIX_n_SOUNDS t3d_add_file_file_Rfile_MIX_n_SOUNDS DESC: As per t3d_add_file_*_Rfile_MORPH_n_IMAGES, but instead of image morphing, the data is treated as audio, and thus "morphing" is made quite different. Audio gets promoted to high-quality before mixing to retain maximum quality and then demoted to result's original quality. t3d_add_file_Rfile_MORPH DESC: This does either image or audio morph, or text morph(...?), as per the t3d_add_file_*_Rfile_MORPH_n_IMAGES and t3d_add_file_*_Rfile_MIX_n_SOUNDS, above. NOTE: To be applicable for textual content files (with their kazillion formats... ugh...) the original should be **in some way** reproducible? Or could this be an alternative way to produce "one-way" hash of text/binary? t3d_add_file_url_OVERWRITE DESC: Transfer the given file to the given url, overwriting target if such exists. t3d_add_file_url_NO_OVERWRITE DESC: As per above, but don't overwrite if target already exists. t3d_add_file_url_OVERWRITE_n_OLDER DESC: As per above, but do overwrite if the target is older than the given file. t3d_add_barray_Rbarray_START_POSITION DESC: Add the given barray to the beginning of the result barray. t3d_add_barray_Rbarray_APPEND DESC: Append the given barray to the end of the result barray. t3d_add_barray_Rbarray_COPY DESC: Copy the given barray to the result barray, overwriting whatever the result barray has contained, if anything. t3d_add_file_dirpath_OVERWRITE t3d_add_file_Rdirpath_OVERWRITE t3d_add_file_dirpath_NO_OVERWRITE t3d_add_file_Rdirpath_NO_OVERWRITE t3d_add_file_dirpath_OVERWRITE_n_OLDER t3d_add_file_Rdirpath_OVERWRITE_n_OLDER DESC: Copy the given file to the given dirpath in the filesystem. The second form appends the given file name to the result dirpath. If the given file name exists at the destination, it'll be overwritten when using OVERWRITE version. With NO_OVERWRITE version copying is not done if the given file name already exists at the destination. With OVERWRITE_n_OLDER version the possibly existing version of the given filename at the destination is overwritten if it's older than the given file. t3d_add_file_Rfile_APPEND DESC: Append the given file to the end of the result file. t3d_add_file_Rfile_START_POSITION t3d_add_file_Rfile_BEGINNING DESC: Insert (or "inject") the given file into the beginning of the result file, enlarging (obviously) the result file by the source file's length. t3d_add_byte_Rbarray_APPEND DESC: Append the given byte to the end of the result barray. t3d_add_byte_Rbarray_START_POSITION t3d_add_byte_Rbarray_BEGINNING DESC: Insert ("inject") the given byte to the beginning of the result barray, increasing the result barray's length by... one byte! ;-) t3d_add_byte_Rbarray_POSXXX t3d_add_int_byte_Rbarray_POSITION DESC: Insert ("inject") the given byte into the result barray at byte offset POSXXX (or POSITION), increasing the result barray's length by one byte. t3d_add_dirpath_Rdirpath_OVERWRITE_n_OLDER DESC: Copy a full directory (the given dirpath) to the result dirpath only if the result dirpath contains an older version of the given dirpath (or doesn't yet contain one at all). The given dirpath is appended to the result dirpath...? Q: Does OVERWRITE_n_OLDER apply also the the directory contents or only to the directory itself? t3d_add_dirpath_Rdirpath_NO_OVERWRITE DESC: As above (t3d_add_dirpath_Rdirpath_OVERWRITE_n_OLDER), but don't overwrite already existing target. Q: Do we recurse through the source and destination for files? t3d_add_byte_Rbarray_RANDOM_n_END t3d_add_Rbarray_RANDOM_BYTE_n_END DESC: Adds a random byte to the end of result barray. Q: Does the given byte for the first form have any other significance but telling the size of addition? t3d_add_file_Rfile_ZIP_ARCHIVE t3d_add_barray_file_Rfile_ZIP_ARCHIVE_n_PASSWORD t3d_add_file_Rfile_ZIP_ARCHIVE_PASSWORDXXX DESC: Adds the given file into the result file, using ZIP compression method for the source. The result file will be password protected if using a form which takes password as parameter. NOTE: If not providing a password for an archive which is already password protected, we can add a file **only** if we've provided the password in an earlier call and/or the result file stream was opened with the correct password... Uh, or something. Q: What if... t3d_add_file_Rfile_ZIP_ARCHIVE_n_NEW t3d_add_file_Rfile_ZIP_ARCHIVE_n_NEW_PASSWORDXXX DESC: Adds the given file into the result file, creating a new ZIP archive of it (possibly with password, given as PASSWORDXXX). If result file already exists, it'll be overwritten. t3d_add_file_Rfile_ARCHIVE_TYPEXXX t3d_add_barray_file_Rfile_ARCHIVE_n_PASSWORD_TYPEXXX t3d_add_file_Rfile_ARCHIVE_TYPEXXX_PASSWORDXXX DESC: Adds the given file into the result file which is treated as TYPEXXX archive (TYPEXXX can be... "zip", "gz", "tar.gz", etc.). If type is omitted (or NULL for passworded version), try autodetect its type? If password is given, and the type supports it, then use it - otherwise ignore it. t3d_ai_barray_Rbarray_QUESTION_n_ANSWER DESC: Tries to provide an answer to some arbitrary question (barray) and provide the answer in the result barray. Q: How do we answer to a question which isn't understood, or for such which we understood but don't know the answer? t3d_ai_barray_Rbarray_TELL_LANGUAGE DESC: Tell in what language the given barray is, providing the answer in the result barray. Q: In case of multiple contexts, eg. source code files, do we answer to the question by programming language name or by the language used in the comments (which may not even exist...)? t3d_calculate_barray_Rtable_FREQUENCY_n_CHARS DESC: Calculate frequency (number of appearances) of individual characters in the given barray, the result returned in a table containing entry for all possible chars (or do we make it 2D, eg. C => X, where C = ASCII code of a character and X is the number of times it exists in the given barray). Q: Is the result table sorted by some method or...? t3d_calculate_barray_Rtable_FREQUENCY_n_NUMBERS DESC: Calculate frequency of numbers in the given barray, the result returned in a table containing an entry for each number and the corresponding count. Q: Is the barray parsed for string-type numbers or do we act by individual chars, searching for numbers which fall into isdigit() category? t3d_calculate_barray_Rtable_FREQUENCY_n_WORDS DESC: Calculate frequency of individual words in the given barray. See 'String Rules' for more info. t3d_calculate_*array_R#_MEDIAN DESC: Calculate the given [b|w|i|l|d]array's median (the middle one of the sorted values), returning the result as corresponding singular type ('#', which can be either byte, wbyte, int, long, or double). t3d_calculate_*array_Rdouble_AVERAGE t3d_calculate_*array_Rdouble_SKEW t3d_calculate_*array_Rdouble_KURTOSIS t3d_calculate_*array_Rdouble_STD_DEVIATION t3d_calcualte_*array_Rdouble_COEFFICIENT_OF_VARIATION DESC: Yeah... math. Result is a double. t3d_calculate_barray_file_OCCURANCE t3d_calculate_barray_file_OCCURANCE_n_NO_CASE DESC: See if the given barray exists in the given file (and how many times?). The second form doesn't care about difference between upper- and lowercase letters. t3d_calculate_barray_WORDS DESC: Calculate number of 'words' in the given barray. See 'String Rules' for more info. t3d_calculate_dirpath_SUBDIRS_n_SIZE DESC: Calculate the given dirpath's (includes its contents) size in bytes. t3d_calculate_barray_NUMBER_OF_n_CHARS t3d_calculate_barray_SIZE_n_BYTES DESC: 1) Calculate the number of chars in the given barray. 2) Calculate the length of the given barray in bytes. NOTE: These two methods may or may not return different results, depending on the internal character representation format (8-bit ASCII, UTF-8, UTF-16, UTF-32/Unicode, etc.). t3d_calculate_barray_NUMBER_OF_n_CHARS_THESEXXX t3d_calculate_barray_NUMBER_OF_n_CHARS_x_NOT_THESEXXX DESC: 1) Calculate number of THESEXXX character(s?) in the given barray. 2) Calculate number of non-NOT_THESEXXX character(s?) in the given barray. t3d_calculate_file_Rbarray_MD5 t3d_calculate_barray_Rbarray_MD5 DESC: Calculate the given file's/barray's MD5 sum, the result barray containing a typical 32-char MD5 string. t3d_calculate_file_LINES DESC: Calculate the number of lines in the given file. NOTE: This is not very straight-forward with some file types... t3d_calculate_#numt_#numt_SUBTRACT DESC: Subtract the 1st #numt from the second(?). Q: What's exactly the order of math here? t3d_calculate_#numt_#numt_ADD t3d_calculate_#numt_#numt_SUM DESC: Calculate the sum of the given #numts (see 'Numeric Types'). NOTE: In theory... the type of # **could** be also a virtual 2D-coordinate (a pair of some datatype, eg. byte & byte, long & long), or 3D-coordinate (a triplet of some datatype, eg. byte-byte-byte, long-long-long, etc.). t3d_calculate_#numt_#numt_DIVIDE_FIRST_n_WITH_SECOND DESC: Divide the first #numt with the second #numt. t3d_calculate_#numt_R#numT_POWER usage( 5, num ) t3d_calculate_R#numT_POWER_POWERXXX usage( num, 5 ) DESC: Rise the result #numT to the power of #numt (or POWERXXX). t3d_calculate_barray_R#numt_EQUATION_n_SIMPLE t3d_calculate_barray_R#numt_EQUATION_n_POLYNOMAL DESC: Treat the given barray as some mathematical formula and calculate the result into the result #numt. Q: What's exactly the internal difference with polynomal and simple, if any? t3d_calculate_Rdouble_SPHERE_n_VOLUME_RADIUSXXX t3d_calculate_Rdouble_SPHERE_n_VOLUME_DIAMETERXXX DESC: Treat the result double as... what?... and calculate it's volume in some arbitrary unit. t3d_calculate_#numt_IS_PRIME DESC: See if the given #numt is a prime number. t3d_calculate_file_file_Rdouble_DIFFERENCE_n_PERCENTAGE DESC: Calculate how much (in percents) the given files differ from each other. Q: How does size and/or size difference of the files affect the equation? c3d_close_file DESC: Close a file stream. c3d_close_url_NETCONNECTION DESC: Break/close a network stream... Q: What about access modes like UDP, which is never "connected" as such? c3d_close_CD_DRIVE c3d_close_CD_DRIVE_x_DRIVE_NUMBERXXX c3d_close_DRIVE_x_DRIVE_NUMBERXXX DESC: 1) close a CD drive(** 2) close a drive number DRIVE_NUMBERXXX. NOTE: tricky... There may or may not be multiple CD-drives (or any other "detachable" media) present. c3d_close_barray_PROCESS DESC: Close a process which name is given as a barray. Q: How the process is closed and what's defined as a "process". Do processes also mean threads/tasks of processing (which does require some sort of IPC to be implemented...)? NOTE: What is a process depends a huge lot on the OS we're running on... c3d_close_USER_SESSION DESC: Log out user nicely. NOTE: The effect of this varies from OS to OS. Some archaic OSes don't even know what's a "user session", but instead having a "session" the "session" begins from turning on the power/rebooting to switching off the computer/rebooting. c3d_close_COMPUTER DESC: Shut down the computer. NOTE: The effect of this varies from OS to OS, and is possibly affected by user permissions, etc. This is somewhat affected also by the hardware, even if the system knows how to shut itself down programmatically (some systems, as we so well know, require you to kick the power switch manually :-P). c3d_close_COMPUTER_n_RESTART DESC: Reboot the computer. NOTE: The effect of this varies from OS to OS, and is possibly affected by user permissions, etc. (UNIX for example doesn't allow reboot by other but those who have been explicit granted the rights to reboot the machinery). c3d_close_NETWORK_n_ALL DESC: Detach the computer completely from all kinds of external networks (whether this means ethernet, serial modem, ADSL, samba, etc.). NOTE: This is very much system dependant, again - some systems allow anyone to switch networking off and some require the caller to have been granted explicit rights for such activity. t3d_close_int_PORT t3d_close_int_PORT_DEVICEXXX DESC: Close the given TCP/UDP port... in either every or a specified (DEVICEXXX) network device. NOTE: This is VERY much system dependant. Q: How the networking devices are named, which networking devices are affected...? t3d_close_gobject DESC: Close the given gobject, and release any and all of its children and all the resources allocated/reserved/opened. t3d_convert_barray_Rbarray_CASE DESC: Do a upper <-> lower case conversion for the given barray and put the converted stuff into the result barray. t3d_convert_barray_Rbarray_2LOWER t3d_convert_barray_Rbarray_2UPPER DESC: Do a to-upper or to-lower case conversion for the given barray and put the converted stuff into the result barray. t3d_convert_barray_Rbarray_CASE_n_SENTENCE DESC: Do the right thing... Convert the first character of each sentence in the given barray to uppercase and put the stuff into the result barray. NOTE: What are the rules for stuff which the writer has *meant* to be lowercase even if as the first word in a sentence? t3d_convert_#numt_Rbarray DESC: Convert the given #numt into a (result) barray (human readable string representation?). t3d_convert_Rfile_READ_ONLY DESC: Mark the result file as read-only. t3d_convert_barray_Rfile_RENAME2 DESC: Treat barray as file/path name and rename the result file thus. t3d_convert_#numt_Rbarray_#NUMT2ROMAN DESC: Convert the given #numt into its Roman numeral string representation into the result barray. t3d_convert_barray_R#numt_ROMAN2#NUMT DESC: Convert the given barray, which is treated as a Roman numeral string, into #numt into the result #numt. t3d_convert_file_Rfile_WAV2MP3_BITRATEXXX t3d_convert_file_Rfile_WAV2OGG_BITRATEXXX DESC: Convert the given (WAV) file to mp3/ogg format into the result file, streaming at bps of BITRATEXXX. t3d_convert_file_Rfile_MP32WAV t3d_convert_file_Rfile_OGG2WAV DESC: Convert the given mp3/ogg file to WAV format into the result file, retaining the number of channels (mono/stereo), quality ([k]Hz) and other such stuffs. t3d_convert_file_Rfile_WAV2PCM DESC: Convert the given WAV file to PCM format into the result file. t3d_convert_barray_Rbarray_REVERSE t3d_convert_Rbarray_REVERSE DESC: Reverse the given barray into the result barray, or convert the result barray in-place. t3d_convert_byte_barray_Rbarray_2BASE DESC: Treat the given barray as... an integer?... and convert it to the given base (determined by the given byte) into the result barray. usage( 16, src, dst ) ...converts src to hex presentation into dst. Q: How do we know the original base of src? t3d_convert_Rfile_CASE_n_SENTENCE DESC: Do the right thing... for the sentences in the result file, converting each sentence's first word's first character to uppercase (in-place). Q: What happens in such special cases where the writer has intended some 'word' to be *always* in lowercase (eg. in case of variable names for programming languages which are case-sensitive)? t3d_convert_barray_Rbarray_2LOWER_LANGUAGEXXX t3d_convert_barray_Rbarray_2UPPER_LANGUAGEXXX DESC: Convert the given barray to lower-/uppercase and translate it to the given language into the result barray... usage( "This String", dst, "Japanese" ) usage( "Tämä juddu, On Oudo...", dst, "Deutsch|Germany" ) t3d_convert_double_R#numt_ROUND t3d_convert_Rdouble_ROUND DESC: Round the given double to the nearest integer (ceiling if #.5+ and flooring if <#.5). Result is put into the result 1)#numt (or should this be **always** long?) or 2)double. t3d_convert_file_Rfile_SENTENCE_PER_LINE DESC: Convert the given file so that the result file will end up with one sentence per line. NOTE: It gets a bit hairy with some file formats... t3d_convert_long_Rbarray_2UNSIGNED_BINARY t3d_convert_long_Rbarray_LONG2BINARY_n_UNSIGNED DESC: Convert the given long to an unsigned binary representation into the result barray. t3d_convert_file_Rfile_COMPRESS_n_RANGE_CODER DESC: Compress the given file into the result file using range coder methodology. t3d_convert_#numt_Rbarray_2BASE TODO: desc DESC: Convert ... eh? t3d_convert_#numt_Rbarray_2BASE_BASEXXX DESC: Convert the given #numt to the given BASEXXX into the result barray. t3d_convert_#numt_Rbarray_UNSIGNED DESC: Convert the given #numt to its unsigned (human readable?) representation into the result barray. t3d_convert_#numt_Rbarray DESC: Convert the given #numt to its (human readable?) representation into the result barray. t3d_convert_file_Rfile_HEX_n_SPACE_SEPARATED DESC: Convert the given file to hexdump (using space as separator between bytes) into the result file. t3d_convert_#numt_Rbarray_HEX t3d_convert_#numt_Rbarray_HEX_n_SPACE_SEPARATED DESC: Convert the given #numt to (human readable?) hex presentation into the result barray. 2) use spaces as byte separator. t3d_calculate_Rdouble_SPHERE_n_VOLUME_RADIUSXXX t3d_calculate_Rdouble_SPHERE_n_VOLUME_DIAMETERXXX DESC: Calculate the volume of a sphere (a ball) which radius/diameter is given. The result double uses same unit base as the given radius/diameter (eg., if radius is given in meters, the result will be given in cubic meters, etc.). t3d_calculate_Rdouble_CUBE_n_VOLUME_SIDEXXX DESC: Calculate the volume of a cube which is the length of its edge (SIDEXXX) cubed. t3d_calculate_Rdouble_SQUARE_n_AREA_SIDEXXX DESC: Calculate the area of a square which each side has length of SIDEXXX. t3d_add_#numt_Rint_APPEND DESC: Append the first given number to the end of the result int. Example: 200 appended to 100 results in 100200 (one hundred thousand two hundred). t3d_write_byte_Rbyte t3d_add_byte_Rbyte_REPLACE DESC: Write the given byte over the result byte. t3d_add_int_Rfile_ADD_CHARS_FILEPOSXXX DESC: Insert the given int in its string presentation into the result file starting at offset FILEPOSXXX, increasing its size by... however many bytes the integer's string representation takes. t3d_add_byte_Rfile_APPEND DESC: Appends the given byte to the end of result file. t3d_add_byte_Rfile_REPLACE_CHAR_FILEPOSXXX DESC: Replaces the byte in the result file at location FILEPOSXXX with the given byte. t3d_add_byte_Rfile_ADD_CHAR_FILEPOSXXX DESC: Inserts the given byte into the result file at location FILEPOSXXX, enlarging the file's size by one byte. t3d_add_byte_int_Rint DESC: Adds the given byte to the given int and stores the sum into the result int. Ex. byte=12, int=1000, Rint=1012. t3d_add_barray_Rfile_ADD_CHARS_FILEPOSXXX DESC: Adds the given barray into the result file at offset FILEPOSXXX, increasing the result file's size by the size of the given barray. t3d_add_barray_Rfile_REPLACE_CHARS_FILEPOSXXX DESC: Writes the given barray into the result file, beginning at offset FILEPOSXXX, overwriting the contents and possibly also increasing the file size. t3d_add_file_url_WHEN_IDLE DESC: Attempt to send the given file to the given url while the computer runs idle. t3d_ai_barray_Rtable_WHO_IS_MAXTIMEXXX DESC: Tries to search information about the named person (or IP/hostname). Result answer(s) will be given in the result table within MAXTIMEXXX seconds. t3d_ai_barray_Rtable_HOW_TO_MAXTIMEXXX DESC: Tries to search an answer to the given "how to"-type question within MAXTIMEXXX seconds. t3d_ai_barray_Rtable_####_IS_MAXTIMEXXX DESC: Tries to search an answer to the given "###"-type question within MAXTIMEXXX seconds. Types of questions are: WHAT, WHO, WHEN t3d_ai_barray_Rtable_WHERE_IS_n_ADDRESS_MAXTIMEXXX DESC: Tries to search an answer to the given "where is" question barray, resulting in street address, city, and country, in the result table, and using no more than MAXTIMEXXX seconds in the attempt. t3d_ai_barray_Rtable_WHERE_IS_n_MAP_LOCATION_MAXTIMEXXX DESC: Tries to search an answer to the given "where is" question barray, resulting in world-map coordinates into the result table, and using no more than MAXTIMEXXX seconds in the attempt. t3d_ai_barray_Rtable_WHERE_IS_n_URLS_MAXTIMEXXX DESC: Tries to search an answer to the given "where is" question barray, resulting in information containing urls into the result table, and using no more than MAXTIMEXXX seconds in the attempt. t3d_ai_file_Rfile_IMAGE2OPENGL_SCENE_MAXTIMEXXX t3d_ai_file_file_Rfile_IMAGE2OPENGL_SCENE_MAXTIMEXXX DESC: Tries to create an OpenGL 3D-scene from the given image file into the result file within MAXTIMEXXX seconds. t3d_ai_dirpath_Rfile_IMAGE_DIR2OPENGL_SCENE_MAXTIMEXXX DESC: As above, but using all the image files found in the dirpath. t3d_convert_file_Rfile_TEXT2HTML DESC: Convert the given file (text, of some format) to HTML into the result file. t3d_convert_file_Rfile_HTML2TEXT DESC: Convert the given (HTML) file to text into the result file. t3d_convert_file_Rfile_2RTF DESC: Convert the given file to RTF-format into the result file. t3d_convert_file_Rfile_2PDF DESC: Convert the given file to PDF-format into the result file. t3d_convert_file_Rfile_LANGUAGEXXX DESC: Convert the language of the given file to LANGUAGEXXX into the result file. t3d_convert_barray_Rbarray_TEXT2WAV t3d_convert_barray_Rbarray_WAV2TEXT t3d_convert_barray_Rfile... t3d_convert_file_Rfile... DESC: Convert the given barray of text to WAV-format into the result barray. 2) convert the given WAV-barray to text into the result barray. t3d_convert_barray_Rbarray_#imagefmt2#imagefmt t3d_convert_file_Rfile_#imagefmt2#imagefmt DESC: Convert an image barray/file to another format into the result barray/file. t3d_convert_dirpath_Rfile_IMAGES2AVI t3d_convert_dirpath_Rfile_IMAGES2AVI_FRAMERATEXXX DESC: Convert the images contentained in the given dirpath to an AVI stream into the result file (either with some default framerate or the given FRAMERATEXXX). t3d_convert_file_Rdirpath_AVI2IMAGES DESC: Convert the given (AVI) file into separate image files into the result dirpath. t3d_convert_file_Rfile_MOVIE2AVI DESC: Convert the given movie file to AVI-format into the result file. t3d_convert_file_Rfile_AVI2#videofmt DESC: Convert the given AVI file to some other video format into the result file. t3d_convert_file_Rfile_MOVIE_FRAMERATEXXX DESC: Convert the given movie file's framerate to FRAMERATEXXX into the result file. t3d_convert_file_Rfile_SIZE_WIDTHXXX_SIZE_HEIGHTXXX DESC: Convert the given file's dimensions to SIZE_WIDTHXXX x SIZE_HEIGHTXXX pixels into the result file. t3d_convert_dirpath_Rfile_MORPH2AVI_n_IMAGES_MAKE_FRAMESXXX DESC: Convert the images found from the given dirpath to MAKE_FRAMESXXX long AVI-stream, morphing from one image to another into the result file. t3d_convert_file_Rfile_WAV2WAV_BITSXXX_MONO_STEREOXXX_HZXXX t3d_convert_barray_Rbarray_WAV2WAV_BITSXXX_MONO_STEREOXXX_HZXXX DESC: Convert the given WAV file into the result (WAV) file which will have BITSXXX bit format, 1-2 channels depending on MONO_STEREOXXX and rate of HZXXX Hz. 2) same, but using barray as input and a barray as result. t3d_convert_barray_Rbarray_WAV2#audiofmt t3d_convert_file_Rfile_WAV2#audiofmt t3d_convert_barray_Rbarray_WAV2#audiofmt_BITRATEXXX t3d_convert_file_Rfile_WAV2#audiofmt_BITRATEXXX DESC: Convert the given WAV barray/file into other audio format into the result barray/file; BITRATEXXX modifying the result's bitrate. t3d_convert_barray_Rbarray_COMPRESS_n_#comprmethod t3d_convert_file_Rfile_COMPRESS_n_#comprmethod t3d_convert_..._COMPRESS_n_#comprmethod_LEVELXXX t3d_convert_..._COMPRESS_n_#comprmethod_PASSWORDXXX t3d_convert_..._COMPRESS_n_#comprmethod_LEVELXXX_PASSWORDXXX DESC: Compress the given barray/file into the result barray/file using one of the possible #comprmethod compression methods (RANGE_CODER, ZIP, ZLIB, RLE). If possible, compression level can be determined with LEVELXXX. If possible, a password can be applied to the result with PASSWORDXXX. t3d_convert_barray_Rbarray_UNCOMPRESS_n_#comprmethod t3d_convert_file_Rfile_UNCOMPRESS_n_#comprmethod t3d_convert_..._UNCOMPRESS_n_#comprmethod_PASSWORDXXX DESC: Uncompress the given barray/file into the result barray/file. The source type being one of the possible #comprmethod compression methods (see ...COMPRESS_n... above). If applicable, a password for uncompressing can be given with PASSWORDXXX. t3d_convert_file_Rfile_IMAGE2SIZE_WIDTHXXX_HEIGHTXXX DESC: Convert the given image file to size of WIDTHXXX x HEIGHTXXX pixels into the result file. t3d_convert_file_Rfile_IMAGE2SIZE_PERCENTAGE_WIDTHXXX_PERCENTAGE_HEIGHTXXX DESC: Convert the given image file to have size of PERCENTAGE_WIDTHXXX% of original width and PERCENTAGE_HEIGHTXXX% of original height into the result file. t3d_crypto_barray_Rbarray_ENCRYPT_n_#encmethod_PASSWORDXXX t3d_crypto_file_Rfile_ENCRYPT_n_#encmethod_PASSWORDXXX DESC: Encrypt the given barray/file into the result barray/file using #encmethod encryption scheme and the password given as PASSWORDXXX. #encmethod is eg. one of: AES256, BLOWFISH, TWOFISH, 3DES t3d_crypto_barray_Rbarray_DECRYPT_n_#encmethod_PASSWORDXXX t3d_crypto_file_Rfile_DECRYPT_n_#encmethod_PASSWORDXXX DESC: Decrypt the given barray/file into the result barray/file using #encmethod encryption scheme and the password given as PASSWORDXXX. See ...ENCRYPT_n_#encmethod... above for the possible encryption schemes. t3d_crypto_file_Rfile_HIDE2IMAGE t3d_crypto_file_Rfile_STEGANOGRAPHY_n_IMAGE DESC: Hide the given file into the result image file using steganography. t3d_crypto_file_Rfile_EXTRACT_HIDDEN_n_FROM_IMAGE t3d_crypto_file_Rfile_UNHIDE_n_STEGANOGRAPHIC_IMAGE t3d_crypto_file_Rfile_REVEAL_STEGANOGRAPHIC_n_FROM_IMAGE DESC: Unhide (reveal) steganographically hidden data from the given image file into the result file. t3d_crypto_file_Rfile_HIDE2SOUND ... DESC: As per t3d_crypto_file_Rfile_HIDE2IMAGE, but using some sound format result file. t3d_crypto_barray_Rbarray_#chksumtype t3d_crypto_file_Rbarray_#chksumtype DESC: Generate #chksumtype of the given barray/file into the result barray. The #chksumtype can be one of the following: MD5, SHA1, TIGER, RIPEMD160 t3d_crypto_barray_file_#chksumtype_n_IS_MATCHING t3d_crypto_barray_barray_#chksumtype_n_IS_MATCHING DESC: Check if the given #chksumtype barray matches with the given second barray (or file). See above for the possible #chksumtypes. t3d_crypto_Rfilepath_RSA2048_n_CREATE_PRIVATE_KEYRING_x_KEYRING_NAMEXXX_PASSWORDXXX t3d_crypto_Rfilepath_RSA4096_n_CREATE_PRIVATE_KEYRING_x_KEYRING_NAMEXXX_PASSWORDXXX DESC: Generate a 2048/4096-bit private keyring with name KEYRING_NAMEXXX and password PASSWORDXXX. The keyring file(s?) is (or are?) written to the result filepath. t3d_crypto_Rlong_RANDOM_n_#rndengine t3d_crypto_Rdouble_RANDOM_n_#rndengine DESC: Generate a random number into the result long/double using #rndengine randomizer engine. The #rndengine can be one of the following: YARROW, BBS t3d_crypto_Rlong_RANDOM_n_#rndengine_MINXXX_MAXXXX t3d_crypto_Rdouble_RANDOM_n_#rndengine_MINXXX_MAXXXX DESC: As above, but keeping generating until the result fits into range of MINXXX and MAXXXX. t3d_crypto_Rbarray_RANDOM_n_#rndengine_LENGTHXXX t3d_crypto_Rbarray_RANDOM_n_#rndengine_LENGTHXXX_MINXXX_MAXXXX DESC: As above, but the result is a barray containing LENGTHXXX randomized entries (possibly limited within range of MINXXX and MAXXXX). t3d_crypto_barray_Rbarray_CRYPTOANALYZE t3d_crypto_barray_Rbarray_CRYPTOANALYZE_MAX_SECONDSXXX DESC: Attempt to decipher the given barray's encrypted contents into the result barray. 2) try to decipher within at max MAX_SECONDSXXX seconds. NOTE: By far this is definitely the most "difficult" (longest taking) function in existence... t3d_create_barray_Rbarray_EMAIL_n_NEW t3d_create_barray_Rfile_EMAIL_n_NEW DESC: Create an email-template of the given barray into the result barray/file. t3d_create_Rfile_RANDOM_BYTESXXX DESC: Create a result file which will contain BYTESXXX random bytes. t3d_create_Rbyte_RANDOM DESC: Generate a random byte into the result byte. t3d_create_SLEEP_MICROSECONDSXXX DESC: Create a MICROSECONDSXXX µs long pause ("sleep") in the program's execution. t3d_create_PAUSE_n_UNTIL_KEYPRESS DESC: Halt execution of the application until it registers a keypress. t3d_create_PAUSE_n_UNTIL_KEYPRESSXXX DESC: Halt execution of the application until it registers pressing of the given key (KEYPRESSXXX). t3d_create_BEEP t3d_create_BEEP_HZXXX t3d_create_BEEP_HZXXX_DURATIONXXX DESC: Generate a 'beep', of either system-default pitch or given pitch (HZXXX), of either system-default length or of specified duration (DURATIONXXX) in seconds. t3d_convert_KEYBOARD_n_DISABLED t3d_create_KEYBOARD_n_DISABLED t3d_convert_KEYBOARD_n_ENABLED DESC: Disable/enabled keyboard. t3d_create_PING_IPXXX DESC: Attempt to ping the IP/hostname IPXXX. t3d_create_SYSTEM_n_SHUTDOWN t3d_create_SYSTEM_n_RESTART DESC: Attempt to shutdown or restart the computer. Effect of this is heavily dependant on the OS and (possibly also) on whether the application and/or its user has been granted rights to such action. t3d_create_USER_n_LOGOUT DESC: Attempt to log the executing user out. Effect of this is heavily dependant on the OS and/or whether the application is running at "background"... t3d_create_Rbarray_SCREEN_CAPTURE t3d_create_Rfile_SCREEN_CAPTURE DESC: Take a snapshot image of the screen into the result barray/file. t3d_create_Rbarray_SCREEN_CAPTURE_n_ACTIVE_WINDOW t3d_create_Rfile_SCREEN_CAPTURE_n_ACTIVE_WINDOW DESC: Take a snapshot image of the currently active window into the result barray/file. t3d_create_Rlong_PROCESS_n_PROCESS_ID DESC: Put the application's process ID into the result long. Effect of this is pretty much dictated by the underlying OS. t3d_create_barray_Rgobject t3d_create_Rgobject DESC: Create a (template) result gobject with the given barray as name. 2) generate a nameless template result gobject. t3d_create_file_Rgobject DESC: Create a gobject from the "instructions" stored in the given file. t3d_environment_Rint_Rint_GET_n_MOUSE_LOCATION DESC: Fetch the mouse cursor XY screen coordinates into the result ints. t3d_environment_int_int_SET_n_MOUSE_LOCATION DESC: Tell the system to put the mouse cursor to the given screen coordinates. t3d_environment_int_int_SET_n_MOUSE_LOCATION_DURING_SECXXX DESC: Tell the system to move the mouse cursor to the given screen coordinates from its current location in DURING_SECXXX seconds (this is animated movement instead of instant location jump). t3d_environment_Rint_Rint_GET_n_SCREEN_SIZE DESC: Fetch screen size (width and height) in pixels into the given result ints. t3d_environment_int_int_SET_n_SCREEN_SIZE DESC: Set screen size to the given pixel width and height. NOTE that the operation of this is very much upto the OS and/or the windowing system (and hardware), which may or may not allow changing of resolution on-fly. And even if change is allowed, it's upto the graphics hardware and/or the OS/windowing system whether it can/is allowed to change into the given size. Q: If the given size is not possible, should we attempt a nearby standard resolution found in typical graphics hardware or should we simply ignore (and/or report an error)? t3d_environment_Rint_GET_SCREEN_n_COLOR_BITS DESC: Return the screen's color depth (in bits) in the result int. t3d_environment_int_SET_SCREEN_n_COLOR_BITS DESC: Set the screen's color depth (in bits). NOTE that the operation of this is very much upto the OS and/or the windowing system (and hardware), which may or may not accept the given number of display bits. Q: If the given number of bits cannot be set, should we attempt a nearby (better?) bit depth or should we simply ignore (and/or report an error)? t3d_environment_Rbarray_LIST_OF_n_PHYSICAL_DRIVES t3d_environment_Rbarray_LIST_OF_n_DRIVES t3d_environment_Rbarray_DRIVE_LIST t3d_environment_Rtable_... DESC: Return a list of drives attached to the system in the result barray/table. Because some systems allow so-called "virtual drives", n_DRIVES/DRIVE_LIST may in some cases report a different list than n_PHYSICAL_DRIVES (which always reports the actual hardware). t3d_environment_Rbarray_USER_n_NAME DESC: Report the username of the owner (executor) of the calling process in the result barray. t3d_environment_Rbarray_LIST_OF_n_VIDEO_CODECS DESC: Report the system-known video codecs in the result barray. NOTE that not all systems have any idea of what a "codec" means, nor can they thus even imagine what codecs the individual display applications can process... t3d_environment_Rint_GET_VOLUME_n_#audiochann DESC: Get volume setting of some #audiochann into the result int. The possible #audiochann versions are: LINE, LINE1, CD, MIDI, PCM, MASTER, LEFT, RIGHT, SPEAKER, IGAIN, DIGITAL1, PHONE_IN, PHONE_OUT, VIDEO, MICROPHONE NOTE that the #audiochann list is at the moment taken from Linux's aumix application. t3d_environment_int_SET_VOLUME_n_#audiochann DESC: Set volume (percentage value ranging from 0 to 100, given as an int) of some #audiochann. See above for the possible #audiochann versions. t3d_environment_Rbarray_LIST_OF_n_CAMERAS t3d_environment_Rtable_LIST_OF_n_CAMERAS DESC: Get information about the cameras (eg. webcams) attached to the system into the result barray/table. t3d_environment_Rlong_TOTAL_SIZE_n_HARDDISK DESC: Get the total of attached harddisks' size into the result long. t3d_environment_Rlong_AVAILABLE_SIZE_n_HARDDISK DESC: Get the amount of available space in the primary harddisk? t3d_environment_Rlong_AVAILABLE_SIZE_n_HARDDISKS DESC: Get the total available space of the attached harddisks' into the result long. t3d_environment_Rlong_AVAILABLE_SIZE_DRIVEXXX DESC: Get the available space of the specified drive (DRIVEXXX) into the result long. NOTE that in case of read-only media (eg. CD, DVD, write-protected (or restricted-access) drives, etc.) the space is reported as 0. t3d_environment_Rlong_SPACE_AVAILABLE_n_THIS_USER DESC: Get the total available disk space for the current user into the result long. NOTE that in systems which recognize disk quota, the space reported differs from AVAILABLE_SIZE_n_HARDDISKS result. t3d_environment_Rlong_SPACE_TOTAL_n_THIS_USER DESC: Report the total disk space used by the current user into the result long. NOTE that in systems which don't recognize ownership of files, the resulting space is the same as what all the files in the system take. t3d_environment_Rlong_RAM_AVAILABLE t3d_environment_Rlong_RAM_AVAILABLE_n_NO_SWAP DESC: Report the total available RAM into the result long, which includes any and all the free swap storage on disk(s). 2) the report doesn't include swap space, instead reporting only the physical RAM. t3d_environment_Rlong_RAM_TOTAL t3d_environment_Rlong_RAM_TOTAL_n_NO_SWAP DESC: Report the maximum RAM the system has into the result long, which includes any and all of the available swap storages' total size. 2) the result doesn't include swap storage information. t3d_environment_Rlong_CPU_n_SPEED_MHZ DESC: Report the system CPU (or CPUs' total in case of multi-core/SMP/MP system) speed in MHz into the result long. t3d_environment_Rint_CPU_n_COUNT DESC: Report the number of CPUs the system has into the result int. t3d_environment_Rint_CPU_n_IDLE_PERCENTAGE t3d_environment_Rdouble_... DESC: Report the idle CPU power as percentage into the result int/double. t3d_environment_Rint_RAM_FREE_n_PERCENTAGE t3d_environment_Rdouble_... t3d_environment_Rint_RAM_FREE_n_SWAPLESS_PERCENTAGE t3d_envrionment_Rdouble_... DESC: Report the percentage of free RAM into the result int/double. 2) don't take swap space into account. t3d_environment_Rtable_LIST_OF_n_PROCESSES DESC: Report the loaded processes information (were they active or "sleeping") into the result table. NOTE that some systems allow anyone to see all system processes and some impose a lot of restrictions on this. At "worst" the listing contains nothing else but the calling process' owner's processes. t3d_environment_Rtable_NETWORK_n_ACTIONS_ALL DESC: Report all the current network activity in the result table. NOTE that some systems allow this while some report nothing else than whether network is up or down if the user has no suitable rights to access detailed network information. t3d_environment_Rtable_NETWORK_n_ACTIONS_TO_PORTXXX t3d_environment_Rtable_NETWORK_n_ACTIONS_FROM_PORTXXX DESC: Report all the current network activity into the result table which is directed to port PORTXXX. 2) report all the activity sourcing from port PORTXXX. NOTE that, as per above, there may be system imposed restrictions to network reporting. t3d_environment_Rtable_NETWORK_n_ACTIONS_TO_IPXXX t3d_environment_Rtable_NETWORK_n_ACTIONS_FROM_IPXXX DESC: as for NETWORK_n_ACTIONS_#_PORTXXX, above, but for the given IP IPXXX. t3d_environment_Rtable_NETWORK_n_TRACE_ROUTE_IPXXX DESC: Attempt to tracert the given IP, writing results into the result table. NOTE that some systems require some sort of operator rights for the user to be able to execute tracert. t3d_environment_Rint_Rint_SIZE_OF_n_WINDOW_WINDOW_IDXXX DESC: Report size of the given window with ID WINDOW_IDXXX into the result ints in pixels. t3d_environment_Rint_Rint_POSITION_OF_n_WINDOW_WINDOW_IDXXX DESC: Report the position of the given window with ID WINDOW_IDXXX into the result ints in pixels from the origo. t3d_environment_Rbarray_IP t3d_environment_Rbarray_NETWORK_n_OWN_IP DESC: Report the system's own IP into the result barray. NOTE that the result may not be what you're expecting in case of systems with more than one active network connection. t3d_environment_Rbarray_NETWORK_n_IP_DEVICEXXX DESC: Report the IP of the given network device DEVICEXXX into the result barray. t3d_environment_Rdouble_NETWORK_IN_n_KBYTES_SEC t3d_environment_Rdouble_NETWORK_OUT_n_KBYTES_SEC DESC: Report the current network input/output in KB/s into the result double. NOTE that this value is a snapshot and you have to monitor the activity for some time to get the actual (average, as it however is) throughput amount. t3d_environment_Rdouble_SPEED_IN_PORTXXX t3d_environment_Rdouble_SPEED_OUT_PORTXXX DESC: Report the input/output speed of the given port PORTXXX into the result double. NOTE that in some systems there's no way to measure dataflow with this much precision. t3d_environment_Rbarray_OS_n_LANGUAGE DESC: Report the language of the OS currently in use into the result barray. t3d_environment_Rbarray_OS DESC: Report the name and version of the OS into the result barray. t3d_environment_Rbarray_KEYBOARD_n_LANGUAGE DESC: Report the language used for keyboard into the result barray. This may or may not be different from the OS_n_LANGUAGE result, depending on eg. user's settings. t3d_environment_barray_SET_KEYBOARD_n_LANGUAGE DESC: Set keyboard language to the given language (barray of language name). NOTE that in some systems this may result in the OS language to change also. t3d_environment_Rbarray_USER_n_LANGUAGE DESC: Get user's preferenced language into the result barray. This may or may not differ from OS and KEYBOARD languages. t3d_environment_Rdirpath_GET_CURRENT DESC: Get current "working directory" into the result dirpath. t3d_environment_USER_n_END_SESSION DESC: Same as t3d_create_USER_n_LOGOUT, above. t3d_environment_Rtime_LOCAL_TIME DESC: Get current, local, time into the result time. t3d_find_byte_barray_FIND_OCCURANCE_n_TOTAL t3d_find_byte_barray_COUNT_ALL_n_NO_CASE t3d_find_byte_file_... t3d_find_barray_barray_... t3d_find_barray_file_... t3d_find_barray_table_... DESC: Find number of occurances of the given byte/barray in the given barray/file (or table in case of barray search). 2) same, but without regard for upper-/lowercase difference. t3d_find_byte_barray_FIND_OCCURANCE_n_FIRST t3d_find_byte_barray_FIND_OCCURANCE_n_LAST t3d_find_byte_barray_FIND_FIRST_n_NO_CASE t3d_find_byte_barray_FIND_LAST_n_NO_CASE t3d_find_byte_file_... t3d_find_barray_barray_... t3d_find_barray_file_... DESC: Find the first/last position (index) of the given byte/barray in the given barray/file. 3/4) same, but don't pay attention to upper-/lowercase difference. t3d_find_byte_barray_FIND_OCCURANCE_n_FIRST_OFFSETXXX t3d_find_byte_file_... t3d_find_barray_barray_... t3d_find_barray_file_... DESC: As above, but starting search from offset OFFSETXXX in the given barray/file. t3d_find_barray_table_Rtable_FIND_ALL t3d_find_barray_table_Rtable_FIND_ALL_n_NO_CASE DESC: Find and collect all instances of the given barray in the given table into the result table. 2) same, but without regard to upper-/lowercase difference. t3d_find_barray_Rdirpath_FILENAME_n_FIRST t3d_find_barray_dirpath_Rdirpah_FILENAME_n_FIRST DESC: Result as the first filename into the dirpath from the given barray. t3d_find_file_dirpath_Rtable_DUPLICATES t3d_find_file_dirpath_Rtable_IDENTICAL DESC: Report dirpaths of duplicates for the given file in the given dirpath into the result table. t3d_find_file_dirpath_Rtable_SIMILAR_PERCENTAGEXXX DESC: Report dirpaths of files in the given dirpath which are similar to the given file by at least PERCENTAGEXXX% into the result table. t3d_find_file_dirpath_Rtable_SIMILAR_n_CREATION_DATE t3d_find_file_dirpath_Rtable_SIMILAR_n_DATE_MODIFIED DESC: Report dirpaths of files in the given dirpath which are similar to the given file by the date of creation/date when modified. t3d_find_file_dirpath_Rtable_CREATED_AFTER t3d_find_file_dirpath_Rtable_CREATED_BEFORE DESC: Report dirpaths of files in the given dirpath into the result table which have been created before/after the given file. t3d_find_dirpath_Rtable_CREATED_AFTER_DATEXXX t3d_find_dirpath_Rtable_CREATED_BEFORE_DATEXXX DESC: Report dirpaths of files in the given dirpath into the result table which have been created before/after the given date DATEXXX. t3d_find_dirpath_IS_VALID DESC: Check if the given dirpath is valid (exists and is accessible). t3d_find_dirpath_CHDIR t3d_environment_dirpath_SET_n_CWD DESC: Change working directory to the given dirpath. t3d_find_url_IS_VALID t3d_find_url_IS_VALID_USERXXX_PASSWORDXXX DESC: Check if the given url is valid (exists and is accessible). 2) same, but provided a username and password for access. t3d_find_url_Rbarray_WHOIS DESC: Fetch WHOIS information for the given url into the result barray. t3d_find_url_OPEN_BROWSER t3d_open_url_BROWSER t3d_environment_url_OPEN_BROWSER DESC: Open the given url into default web browser of choice. NOTE that if the system hasn't (or doesn't support) associations for eg. URLs, then you have to use the next function(s): t3d_find_url_barray_OPEN_BROWSER t3d_open_url_barray_BROWSER DESC: Open the given url in the browser which name is given in a barray. t3d_find_gobject_IS_OVER_PIXELXXXX_PIXELYXXX DESC: Find if the given gobject is covering the pixel XY-coordinate PIXELXXXX/PIXELYXXX. t3d_find_table_Rtable_WHICH_n_ROWS_CONTAINXXX t3d_find_table_Rtable_WHICH_n_ROWS_NOT_CONTAINXXX DESC: Fetch rows from the given table into the result table which match a SQL SELECT clause CONTAINXXX. 2) same, but rows which don't match the query. t3d_find_table_Rtable_WHICH_n_ROWS_FIELDXXX_CONTAINXXX t3d_find_..._NOT_FIELDXXX_NOT_CONTAINXXX DESC: as above, but search from the given field FIELDXXX contents only. 2) same, but from all other fields but NOT_FIELDXXX and searching for data which doesn't match NOT_CONTAINXXX t3d_measure_barray_LENGTH DESC: measure the given barray's length. t3d_measure_barray_ENTROPY DESC: measure the given barray's entropy. t3d_calculate_file_Rdouble_AVERAGE_n_CHAR DESC: Calculate the average value of bytes in the given file into the result double. t3d_ai_barray_Rbarray_SORT_n_ASCENDING t3d_ai_barray_Rbarray_SORT_DELIMITERXXX t3d_ai_barray_Rbarray_SORT_n_ASCENDING_DELIMITERXXX DESC: Sort the contents of the given barray into the result barray. 2/3) same, but using DELIMITERXXX as entry delimiter within the given barray. t3d_ai_barray_Rbarray_SORT_n_DESCENDING t3d_ai_barray_Rbarray_SORT_n_DESCENDING_DELIMITERXXX DESC: Sort the contents of the given barray into the result barray in descending order. 2) same, but using DELIMITERXXX as entry delimiter within the given barray. t3d_ai_file_Rtable_FIND_MAXTIMEXXX DESC: Find all dirpaths, urls, etc. into the result table where the given file exists, using no more than MAXTIMEXXX seconds to fill the table. t3d_calculate_file_LINE_LENGTH_n_MAX DESC: Calculate the length of the longest line in the given file in characters. t3d_calculate_file_Rdouble_MEAN_n_COLOR DESC: Calculate the "average color" of the given image file into the result double. t3d_convert_barray_file_Rfile_RENAME2 DESC: Rename the given file into the result file using the given barray as name. t3d_convert_dirpath_Rtable_SORT_n_BY_DATE t3d_convert_dirpath_Rtable_SORT_n_BY_SIZE t3d_convert_dirpath_Rtable_SORT_n_BY_NAME DESC: Sort the contents of the given dirpath into the result table by date, size, or name. t3d_convert_byte_Rint DESC: Convert the given byte into an int into the result int. t3d_convert_Rbarray_TRIM_n_SPACES DESC: Trim extra spaces from the result barray. 2+ spaces will be converted into one and all the whitespace before and after the string(s) in the barray will be removed. t3d_convert_Rbarray_TRIM_n_LEFT DESC: Trim the left side of the result barray's strings, removing all the whitespace before them. t3d_convert_Rbarray_TRIM_n_RIGHT DESC: as above, but for the strings' right side (the ends of strings). t3d_convert_file_Rfile_SOUND2WAV DESC: Convert the given sound file to WAV format into the result file. t3d_create_barray_Rgtable DESC: Create an "empty" result gtable which name is given as a barray. t3d_create_barray_Rgtable_TAB_PAGE_n_NAME DESC: Create an "empty" tab-page type result gtable which name is given as a barray. t3d_create_barray_Rgtable_MENU DESC: Create a menu-strip type result gtable which name (id) is given as a barray. t3d_add_barray_Rgtable_SUB_MENU_IDXXX DESC: Adds a submenu to result menu-strip gtable, with sub-menu's id given as a barray and "parent" given id as IDXXX (eg. to make a "child" sub-menu for the main menu-strip's "File_menu" entry, issue t3d_add_barray_Rgtable_SUB_MENU_IDXXX( "f_child", menu, "File_menu" ); t3d_create_barray_Rgobject_BUTTON t3d_create_barray_barray_Rgobject_BUTTON t3d_create_barray_file_Rgobject_BUTTON_n_IMAGE DESC: Create a button type result gobject which name (id) is given as a barray. 2) same, but with another barray (2nd) as the text to be present in the button. 3) same, but output the given image file as the button's representation. t3d_create_barray_Rfile_TEMPORARY_FILE DESC: Create a temporary result file which name is given as a barray. t3d_create_barray_DIRECTORY t3d_create_barray_Rdirpath_DIRECTORY DESC: Create a directory which name is given as a barray into the dirpath, if given, and write the new dirpath into the result dirpath. If no dirpath is given, assume that the user wants the directory to be created in the current work directory. t3d_create_barray_Rdirpath_DIRECTORY_n_PROPERTIES_HIDDENXXX_ARCHIVEXXX_READONLYXXX DESC: Create a directory which name is given as a barray into the dirpath with given properties (true/false): HIDDENXXX (determines if the directory is to be hidden(* ), ARCHIVEXXX (determines if the directory will have so-called "archive bit" set), READONLYXXX (determines whether the directory is to be flagged read-only). NOTE that this function is very OS-specific. Not many systems know about "archive" bit, for example, and for some systems read-only has various meanings (eg. the directory cannot be written into, and/or the directory cannot be deleted, etc.). t3d_create_barray_Rdirpath_DIRECTORY_n_PROPERTIES_CHMODXXX DESC: as above, but using *nix style "chmod" flagging for the directory. Some of the flags are *nix specific and some have effect in other systems too. t3d_create_barray_Rdirpath_DIRECTORY_n_PROPERTIES_HIDDENXXX_ARCHIVEXXX_READONLYXXX_CHMODXXX DESC: as the two above, but combining the flagging methods. NOTE that chmod flags have precedence over Windows-style flags, if applicable, regardless whether the system supports all of the chmod flags. This saying, if eg. "READONLYXXX" is set but the chmod flags have "w" bit(s) set, the created directory is NOT read-only... or something. NOTE that in any case, whatever flags there is that the underlying OS doesn't understand, such flags will be silently ignored. Q: in case of flag-clash, should we report "PARTIAL_SUCCESS" instead of "SUCCESS" so that the user knows the directory was created, but not everything was set as requested? t3d_create_barray_Rdirpath_FILE t3d_create_..._n_PROPERTIES_CHMODXXX t3d_create_..._n_PROPERTIES_HIDDENXXX_ARCHIVEXXX_READONLYXXX t3d_create_..._n_PROPERTIES_HIDDENXXX_ARCHIVEXXX_READONLYXXX_CHMODXXX DESC: Create an empty file which name is given as a barray into the dirpath, and the file's fully resolved dirpath then into the result dirpath. 2) same, but apply *nix style "chmod" flags to the file. 3) same, but use Windows style hidden/archive/readonly flagging(*. 4) same, but combine "chmod" and Windows style flagging. NOTE that, as for directories, setting file properties is very much OS and filesystem specific, and that chmod flags have higher priority than the Windows-style flags. t3d_convert_barray_Rdirpath_OWNER_n_NAME t3d_convert_barray_Rdirpath_OWNER_n_GROUP t3d_convert_Rdirpath_OWNER_NAMEXXX_GROUPXXX t3d_convert_..._Rfile_... DESC: Change ownership of the result dirpath/file. 1) change owner name, 2) change owner group name, 3) change owner name and group name. NOTE that these functions are a no-op in systems which don't have a clue about ownership of directories and files. NOTE also that the OS, even if allows and understands ownership change, may (or may not) impose restrictions on whether the given dirpath's (or file's) ownership can be changed by the calling user. t3d_create_barray_Rfile_EMAIL_x_SENDERXXX_RECIPIENTSXXX_CCXXX_BCCXXX_SUBJECTXXX_BODYXXX_ATTACHMENTXXX t3d_create_barray_Rfile_EMAIL_x_SENDERXXX_RECIPIENTSXXX_CCXXX_BCCXXX_SUBJECTXXX_BODYXXX_ATTACHMENTXXX_PRIORITYXXX DESC: Create an email result file with SENDERXXX as sender, RECIPIENTXXX (barray/table?) as recipients, CCXXX (barray/table?) as CC (carbon-copy), BCCXXX (blind carbon-copy) as BCC, SUBJECTXXX as subject, BODYXXX as body, ATTACHMENTXXX (table/dirpath/file?) as attachment(s), and PRIORITYXXX (1-5 or "Highest", "High", "Normal", "Low", "Lowest") as priority. If priority is 0 or omitted, the priority is assumed to be the default of "Normal". t3d_find_#numt_file_TOTAL t3d_find_#numt_file_TOTAL_n_AS_TEXT t3d_find_#numt_barray_TOTAL t3d_find_#numt_barray_TOTAL_n_AS_TEXT DESC: Find the total number of occurances of the given #numt in the given file/barray. 2) same, but searching for the #numt's string representations in the given file. 3/4) same, but searching in a barray. t3d_find_#numt_file_LAST t3d_find_#numt_file_LAST_n_AS_TEXT t3d_find_#numt_barray_... DESC: Find offset of the last occurance of the given #numt in the given file/barray. ..._n_AS_TEXT) same, but searching for the given #numt's string representation. t3d_find_#numt_file_FIRST t3d_find_#numt_file_FIRST_n_AS_TEXT t3d_find_#numt_barray_... DESC: as above, but for the first occurance. t3d_find_file_dirpath_Rtable_SIMILAR_FILES DESC: Fill the result table with dirpaths of the files similar to the given file in the given dirpath. Q: what determines "similarity"? t3d_measure_barray_NUMBER_OF_n_WORDS t3d_measure_file_NUMBER_OF_n_WORDS DESC: Calculate the number of individual 'words' in the given barray/file. t3d_measure_barray_barray_Rdouble_SIMILARITY DESC: measure the given two barrays' similarity percentage into the result double. t3d_measure_barray_barray_SIMILARITY DESC: measure the given two barrays' similarity... That is, the number of similar bytes. t3d_measure_barray_barray_DIFFERENCE DESC: measure the given two barrays' difference... That is, the number of different bytes. t3d_measure_file_Rbarray_OWNER DESC: results in the given file's owner into the result barray. NOTE that not all systems know about ownership... and in that case the file's owner "is" whoever calls this function. t3d_measure_file_SIZE DESC: measure the given file's size in bytes. t3d_measure_file_DATE_n_CREATION DESC: "measure" the given file's date of creation. t3d_measure_file_DATE_n_MODIFIED DESC: "measure" the given file's last modification date. t3d_measure_file_IS_ACCESS_n_WRITE t3d_measure_file_IS_ACCESS_n_READ t3d_measure_dirpath_... DESC: "measure" whether the given file/dirpath is writeable/readable by the calling user. t3d_measure_file_Rbarray_INFO DESC: "measure" all available information out of the given file into the result barray. The result contains: file size, file flags, file type (MIME), date of creation, date of last modification, date of last access, dirpath of the file,... etc. NOTE that some systems report more info and some report less, and that eg. MIME type of a file cannot be easily determined for some files (in which case none is given?)... t3d_measure_file_file_IS_DIFFERENT DESC: see if the two given files are different. t3d_measure_file_file_IS_SIMILAR DESC: see if the two given files are similar. Q: what determines "similarity"? t3d_measure_dirpath_SIZE DESC: measure the number of bytes contained in the given dirpath. t3d_measure_dirpath_SIZE_n_PHYSICAL DESC: measure how much actual space (in bytes) the given dirpath takes. This will definitely (in most cases) differ from the size reported by t3d_measure_dirpath_SIZE because the hardware doesn't store stuff haphazardly as bytes but instead stores them in "blocks" (which vary in size from eg. 256 bytes to 8192 bytes and beyond). t3d_measure_dirpath_NUMBER_OF_n_FILES DESC: measure the number of files contained in the given dirpath. t3d_measure_url_IS_VALID DESC: see t3d_find_url_IS_VALID t3d_measure_url_IS_ACTIVE DESC: measure if the given url is "active". Q: what's the definition for "active"? t3d_measure_url_FILE_SIZE DESC: measure the file size in bytes the given url would take in the system. t3d_measure_url_SPEED DESC: measure the speed (in KB/s) of the given url. t3d_add_int_Rint DESC: add the given int to the result int. t3d_add_byte_byte t3d_add_byte_byte_Rint DESC: add the 1st given byte to the 2nd given byte (and possibly storing the result into a result int). t3d_write_barray_Rbarray DESC: overwrite the result barray with the given barray. t3d_write_barray_Rfile t3d_write_barray_Rfile_OFFSETXXX DESC: overwrite the contents of the result file with the given barray. 2) same, but begin writing from byte offset OFFSETXXX; file size grows if write extends beyond its original length; file is truncated if write ends before original file's length is reached. t3d_ai_barray_Rtable_PRICE_INFORMATION_n_GLOBAL t3d_ai_..._n_LOCAL DESC: attempt to fill the result table with global/local price information about the product given as a barray. t3d_ai_barray_REPUTATION_MAXTIMEXXX t3d_ai_file_... DESC: attempt to determine whether the given barray data/file has good or bad reputation, using at most MAXTIMEXXX seconds to get an answer produced. t3d_calculate_barray_barray_Rbarray_EQUATION_n_PAIR DESC: calculate the result of given equation pairs (1st and 2nd barray) into the result barray. c3d_close_table DESC: attempt to close whatever is given in the table. c3d_close_table_COMPRESS DESC: attempt to close (and compress, if such is some entities behavior) whatever is given in the table. c3d_close_table_COMPRESS_n_ENCRYPT_PASSWORDXXX DESC: as above, but also encrypted and with password PASSWORDXXX. t3d_close_WINDOW_GTABLEXXX DESC: close window which 'critical' information is given in gtable GTABLEXXX t3d_close_gtable t3d_close_gobject DESC: close whatever graphical entity is given as gtable/gobject t3d_crypto_Rbarray_Rbarray_RSA2048_n_CREATE_KEYPAIR t3d_crypto_Rbarray_Rbarray_RSA4096_n_CREATE_KEYPAIR DESC: create a 2048/4096-bit public key into the first result barray (public keyring) from the private key ring given in 2nd result barray. The generated public key is, of course, also attached to the private key ring. t3d_crypto_file_Rbarray_DECRYPT_n_PRIVATE_KEY_PASSWORDXXX DESC: the given file contains a private key which is used to decrypt the result barray with password PASSWORDXXX. t3d_crypto_barray_Rbarray_2PUBLIC_KEYRING DESC: append the given barray as public key to the public keyring result barray. t3d_environment_Rbarray_KEYBOARD_HOOK t3d_environment_Rfile_... DESC: get current keyboard hooks into result barray/file. NOTE that the keyboard hook list is OS-specific, and thus doesn't include any application-specific hooks that don't affect the system in general but one application only (that is, the hook isn't a global hook). t3d_measure_file_Rdirpath_GETPATH DESC: "measure" the given file's dirpath into the result dirpath. t3d_read_int_file_Rbarray_SIZE_n_DATA t3d_read_..._n_DATA_OFFSETXXX DESC: read given number of bytes from the given file into the result barray. 2) same, but begin reading from byte offset OFFSETXXX in the source file. t3d_write_url_Rbarray t3d_write_url_Rfile DESC: "blind write" the given url into the result barray/file. NOTE that if the given url is a "directory" (ie. not pointing to a downloadable file), the result file will most probably contain whatever the url sends as index, if anything. t3d_write_url_Rdirpath_ALL t3d_write_url_Rdirpath_ALL_n_UPDATED DESC: trawl the given url into the result dirpath as individual file(s). 2) same, but fetch only those files which have been updated (or are new) since last trawl (so-called "site-mirror" operation). NOTE that the result of this varies by the URL's server. Some servers allow site trawling while some others put a definite stop for such behavior... t3d_write_url_Rtable_ALL t3d_write_url_Rtable_ALL_n_UPDATED DESC: trawl the given url as "sub-URLs" into the result table. This is similar to trawling the whole site, above, but actual data is not retrieved - only URLs pointing to eg. files and subdirs. 2) same, but fetch only sub-URLs which point to files/subdirs that have been updated (or are new) since last trawl. NOTE that the result of this varies from server to server, as per t3d_write_url_Rdirpath_ALL, above.