Tk_GetPixelsFromObj
NAMESYNOPSIS
ARGUMENTS
DESCRIPTION
KEYWORDS
___________________________
NAME
Tk_GetPixelsFromObj, Tk_GetPixels, Tk_GetMMFromObj, Tk_GetScreenMM − translate between strings and screen units
SYNOPSIS
#include <tk.h>
int
Tk_GetPixelsFromObj(interp, tkwin, objPtr,
intPtr)
int
Tk_GetPixels(interp, tkwin, string,
intPtr)
int
Tk_GetMMFromObj(interp, tkwin, objPtr,
doublePtr)
int
Tk_GetScreenMM(interp, tkwin, string,
doublePtr)
ARGUMENTS
|
Tcl_Interp *interp (in) |
Interpreter to use for error reporting. | ||
|
Tk_Window tkwin (in) |
Window whose screen geometry determines the conversion between absolute units and pixels. | ||
|
Tcl_Obj *objPtr (in/out) |
String value specifies a distance on the screen; internal rep will be modified to cache converted distance. | ||
|
const char *string (in) |
Same as objPtr except specification of distance is passed as a string. | ||
|
int *intPtr (out) |
Pointer to location in which to store converted distance in pixels. | ||
|
double *doublePtr (out) |
Pointer to location in which to store converted distance in millimeters. |
______________
DESCRIPTION
These procedures take as argument a specification of distance on the screen (objPtr or string) and compute the corresponding distance either in integer pixels or floating-point millimeters. In either case, objPtr or string specifies a screen distance as a floating-point number followed by one of the following characters that indicates units:
|
<none> |
The number specifies a distance in pixels. | ||
|
c |
The number specifies a distance in centimeters on the screen. | ||
|
i |
The number specifies a distance in inches on the screen. | ||
|
m |
The number specifies a distance in millimeters on the screen. | ||
|
p |
The number specifies a distance in printer’s points (1/72 inch) on the screen. |
Tk_GetPixelsFromObj converts the value of objPtr to the nearest even number of pixels and stores that value at *intPtr. It returns TCL_OK under normal circumstances. If an error occurs (e.g. objPtr contains a number followed by a character that is not one of the ones above) then TCL_ERROR is returned and an error message is left in interp’s result if interp is not NULL. Tk_GetPixelsFromObj caches information about the return value in objPtr, which speeds up future calls to Tk_GetPixelsFromObj with the same objPtr.
Tk_GetPixels is identical to Tk_GetPixelsFromObj except that the screen distance is specified with a string instead of an object. This prevents Tk_GetPixels from caching the return value, so Tk_GetAnchor is less efficient than Tk_GetPixelsFromObj.
Tk_GetMMFromObj and Tk_GetScreenMM are similar to Tk_GetPixelsFromObj and Tk_GetPixels (respectively) except that they convert the screen distance to millimeters and store a double-precision floating-point result at *doublePtr.
KEYWORDS
centimeters, convert, inches, millimeters, pixels, points, screen units
More Linux Commands
manpages/XML::LibXML::Literal.3pm.html
XML::LibXML::Literal(3pm) - Simple string values. (ManPage)
XML::LibXML::Literal.3pm - In XPath terms a Literal is what we know as a string. API new($string) Create a new Literal object with the value in $string. Note th
manpages/ed.1.html
ed(1) - text editor (Commands - Linux manual page)..........
ed is a line-oriented text editor. It is used to create, display, modify and otherwise manipulate text files. red is a restricted ed: it can only edit files in
manpages/gnutls_openpgp_keyring_get_crt_count.3.html
gnutls_openpgp_keyring_get_crt_count(3) - API function......
This function will return the number of OpenPGP certificates present in the given keyring. RETURNS the number of subkeys, or a negative error code on error. REP
manpages/mdoc-validate.1.html
mdoc-validate(1) - (unknown subject) - Linux manual page....
mdoc validate validates the specified PATHS against a specified format schema. OPTIONS --format=FORMAT The documentation format to validate PATHS against. Suppo
manpages/pppoe-status.8.html
pppoe-status(8) Shell script to report on status of PPPoE li
pppoe-status is a shell script which checks the status of the PPPoE link established by the Roaring Penguin user-space PPPoE client. If you omit config_file, th
manpages/SDL_GLattr.3.html
SDL_GLattr(3) - SDL GL Attributes - Linux manual page.......
While you can set most OpenGL attributes normally, the attributes list above must be known before SDL sets the video mode. These attributes a set and read with
manpages/Unicode::Collate::CJK::GB2312.3pm.html
Unicode::Collate::CJK::GB2312(3pm) - weighting CJK Unified I
Unicode::Collate::CJK::GB2312 provides weightGB2312(), that is adequate for overrideCJK of Unicode::Collate and makes tailoring of CJK Unified Ideographs in the
manpages/has_key.3ncurses.html
has_key(3ncurses) - get (or push back) characters from curse
The getch, wgetch, mvgetch and mvwgetch, routines read a character from the window. In no-delay mode, if no input is waiting, the value ERR is returned. In dela
manpages/xxd.1.html
xxd(1) - make a hexdump or do the reverse. - Linux man page
xxd creates a hex dump of a given file or standard input. It can also convert a hex dump back to its original binary form. Like uuencode(1) and uudecode(1) it a
manpages/Tk_PhotoBlank.3.html
Tk_PhotoBlank(3) - manipulate the image data stored in a pho
Tk_FindPhoto returns an opaque handle that is used to identify a particular photo image to the other procedures. The parameter is the name of the image, that is
manpages/FcPatternFormat.3.html
FcPatternFormat(3) - Format a pattern into a string accordin
Converts given pattern pat into text described by the format specifier format. The return value refers to newly allocated memory which should be freed by the ca
manpages/wctomb.3.html
wctomb(3) - convert a wide character to a multibyte sequence
If s is not NULL, the wctomb() function converts the wide character wc to its multibyte representation and stores it at the beginning of the character array poi
