diff options
author | scuri <scuri> | 2010-06-24 19:16:35 +0000 |
---|---|---|
committer | scuri <scuri> | 2010-06-24 19:16:35 +0000 |
commit | da0f58cecf7a5280df7efa4e8d4443cb65b0fe1d (patch) | |
tree | d218429e378e665654db9a41e103e50f727e3e5e /html/en/drv | |
parent | 57d27736fe65aa25f8c03c790c11475cc06d1296 (diff) |
*** empty log message ***
Diffstat (limited to 'html/en/drv')
-rw-r--r-- | html/en/drv/gl.html | 63 | ||||
-rw-r--r-- | html/en/drv/pdf.html | 7 |
2 files changed, 60 insertions, 10 deletions
diff --git a/html/en/drv/gl.html b/html/en/drv/gl.html index 2b94b10..cff89db 100644 --- a/html/en/drv/gl.html +++ b/html/en/drv/gl.html @@ -10,6 +10,9 @@ .style1 { margin-top: 0px; } +.style2 { + font-family: Courier; +} </style> </head> @@ -17,13 +20,38 @@ <h2>GL Driver</h2> - <p>This driver represents a basic driver for all system-dependent drivers - implemented in the X-Windows system using the <a href="http://www.opengl.org/"> - OpenGL</a> SDK. The implementation uses the OpenGL, GLU and GLX API functions. + <p>This driver represents a driver for drawing using + <a href="http://www.opengl.org/"> + OpenGL</a>. The implementation uses the OpenGL functions only. For the font support, this driver uses the <a href="http://homepages.paradise.net.nz/henryj/code/index.html#FTGL">FTGL</a> API functions, which it was written against the <a href="http://www.freetype.org/">Free Type</a> library.</p> +<p>The driver is not dependent of system functions. It uses only the OpenGL +portable funtions. So if the window canvas changes its size the attribute "SIZE" +must be set with the new size or cdCanvasGetSize will return an incorrect value.</p> + +<h3>Use</h3> + + <p>The canvas is created by means of a call to the function <font face="Courier"> + <a href="../func/init.html#cdCreateCanvas"><strong>cdCreateCanvas</strong></a>(CD_GL, + Data)</font>, after which other functions in the CD library can be called as usual. The <font face="Courier">Data</font> parameter string has the following format:</p> + + <pre><em>"width<strong>x</strong>height [resolution]"</em> in C "<em><strong><tt>%dx%d %g"</tt></strong></em></pre> + + <p>It must include the initial canvas' dimensions.<font face="Courier"> Width</font> and <font face="Courier">height</font> + are provided in pixels (note the lowercase "x" between them). The + resolution is optional, its default value is "3.78 pixels/mm" (96 DPI).</p> + + + + <p>To use this driver, the application must be linked with the "<strong>cdgl</strong>", + the ftgl library + and the OpenGL library. The FTGL library is dependent also on the GLU + library.</p> + <p>In Lua, it is necessary to call function <font face="Courier"> <strong>cdluagl_open() </strong> </font>after a call + to function <strong><font face="Courier">cdlua_open()</font></strong>, apart from linkediting with the "<strong><font face="Courier">cdluagl</font></strong>" + library. This is not necessary if you do require"cdluagl". </p> <h3>Behavior of Functions</h3> <h4>Control </h4> @@ -79,9 +107,11 @@ <font face="Courier"><strong>NativeFont</strong></font></a>: also accepts the X-Windows font string format.</li> <li><a href="../func/text.html#cdFont"> - <font face="Courier"><strong>Font</strong></font></a>: "Courier" is mapped to + <font face="Courier"><strong>Font</strong></font></a>: In Windows, "Courier" is mapped to "Courier New", "Helvetica" is mapped to "Arial", and "Times" is mapped to - "Times New Roman". Underline and Strikeout are NOT supported.</li> + "Times New Roman". In UNIX, "Courier" is mapped to + "freemono", "Helvetica" is mapped to "freesans", and "Times" is mapped to + "freeserif". Underline and Strikeout are NOT supported.</li> </ul> <h4>Colors </h4> <ul> @@ -92,6 +122,23 @@ <h4>Exclusive Attributes</h4> <ul> + <li>"<b><font face="Courier">ALPHA</font></b>": allows the usage of an alpha + channel for the drawing shapes. Assumes values "1" (active) and "0" + (inactive). Default value: "1".</li> +</ul> + +<ul> + <li>"<b><font face="Courier">ANTIALIAS</font></b>": allows the use of + anti-aliasing for the drawing shapes. Assumes values "1" (active) and "0" + (inactive). Default value: "1".</li> +</ul> + +<ul> + <li><b><font face="Courier">"GLVERSION": </font></b>returns a string with + the OpenGL version or release number. It is empty if the OpenGL is not available.</li> +</ul> + +<ul> <li>"<b><font face="Courier">ROTATE</font></b>": allows the usage of 1 angle and 1 coordinate (x, y), that define a global rotation transformation centered in the specified coordinate. Use 1 real and 2 integer values inside a @@ -99,8 +146,10 @@ </ul> <ul> - <li><b><font face="Courier">"GLVERSION": </font></b>returns a string with - the OpenGL version or release number. It is empty if the OpenGL is not available.</li> + <li>"<strong><span class="style2">SIZE</span></strong>": sets the canvas size. + Must be used after the window is resized. The format is the same of the data + parameter in cdCreateCanvas, <em>"width<strong>x</strong>height [resolution]"</em> + or in C "<em><strong><tt>%dx%d %g".</tt></strong></em></li> </ul> </body> diff --git a/html/en/drv/pdf.html b/html/en/drv/pdf.html index d111a90..c161eeb 100644 --- a/html/en/drv/pdf.html +++ b/html/en/drv/pdf.html @@ -46,6 +46,10 @@ or in C<em> <p>To use this driver, the application must be linked with the "<strong>cdpdf</strong>" and "<strong>pdflib</strong>" libraries. </p> + <p>In Lua, it is necessary to call function <font face="Courier"> <strong>cdluapdf_open() </strong> </font>after a call + to function <strong><font face="Courier">cdlua_open()</font></strong>, apart from linkediting with the "<strong><font face="Courier">cdluapdf</font></strong>" + library. This is not necessary if you do require"cdluapdf".</p> + <p><b>Paper Size - </b>The default paper size is A4. It is possible to change it by using one of the predefined sizes - <strong><tt>CD_A0</tt></strong>, <strong><tt>CD_A1</tt></strong>, <strong><tt>CD_A2</tt></strong>, <strong><tt>CD_A3</tt></strong>, <strong><tt>CD_A4</tt></strong>, <strong><tt>CD_A5</tt></strong>, <strong><tt>CD_LETTER</tt></strong> and <strong><tt> @@ -111,9 +115,6 @@ or in C<em> default value is 300 DPI.</p> <p><b>Orientation -</b> The page can be oriented as portrait or landscape. The default value is portrait, but when the parameter "-o" is used, the horizontal and vertical values are switched.</p> - <p>In Lua, it is necessary to call function <strong><font face="Courier">cdluapdf_open() </strong> </font>after a call - to function <strong><font face="Courier">cdlua_open()</font></strong>, apart from linkediting with the "<strong><font face="Courier">cdluapdf</font></strong>" - library. This is not necessary if you do require"cdluapdf".</p> <h3>Behavior of Functions</h3> <h4>Control</h4> |