291 lines
11 KiB
HTML
291 lines
11 KiB
HTML
<html>
|
||
|
||
<head>
|
||
<meta http-equiv="Content-Type"
|
||
content="text/html; charset=iso-8859-1">
|
||
<meta name="GENERATOR" content="Microsoft FrontPage Express 2.0">
|
||
<title>VISION Documentation (LDV): Defines</title>
|
||
</head>
|
||
|
||
<body background="images/conc2.gif" bgcolor="#FFFFFF">
|
||
<div align="center"><center>
|
||
|
||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||
<tr>
|
||
<td align="center" width="17%"><a href="descrip.htm"><img
|
||
src="images/cprev.jpg" alt="Previous Chapter "
|
||
border="0" hspace="2" width="46" height="26"></a><a
|
||
href="index.htm"><img src="images/csom.jpg"
|
||
alt="Back to content " border="0" hspace="2" width="26"
|
||
height="26"></a><a href="struct.htm"><img
|
||
src="images/csuiv.jpg" alt="Next Chapter " border="0"
|
||
hspace="2" width="43" height="26"></a></td>
|
||
<td align="center" valign="top" rowspan="2" width="8%"><p
|
||
align="center"><img src="images/icoprinc.gif" width="59"
|
||
height="71"></p>
|
||
</td>
|
||
<td width="33%"><p align="center"><font color="#0000FF"
|
||
size="5"><strong><em>VISION </em>Documentation
|
||
<em>(LDV)</strong></em></font></p>
|
||
</td>
|
||
<td align="center" valign="top" rowspan="2" width="8%"><p
|
||
align="center"><img src="images/icointro.gif" width="59"
|
||
height="71"></p>
|
||
</td>
|
||
<td valign="top" width="17%"><p align="left">Last update:
|
||
<!--webbot bot="Timestamp" startspan
|
||
s-type="EDITED" s-format="%d/%m/%y" -->29/10/00<!--webbot
|
||
bot="Timestamp" i-checksum="12232" endspan --></p>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="17%"><p align="center"><a
|
||
href="..\..\download/dvldv.zip">Download documentation</a></p>
|
||
</td>
|
||
<td width="33%"><p align="center"><font size="4"><strong>4.
|
||
D E F I N E S</strong></font></p>
|
||
</td>
|
||
<td align="center" width="17%"> <!--webbot
|
||
bot="HTMLMarkup" startspan --><A HREF="http://www.estat.com/getstats?serial=1390118421">
|
||
<IMG SRC="http://perso.estat.com/cgi-bin/perso/1390118421?page=DocVisionLDV"
|
||
BORDER=0></A>
|
||
<!--webbot
|
||
bot="HTMLMarkup" endspan --></td>
|
||
</tr>
|
||
</table>
|
||
</center></div>
|
||
|
||
<hr>
|
||
|
||
<p><a name="LDV_STATUS"></a><font size="4"><strong>4.1 Type of return codes
|
||
</strong></font></p>
|
||
|
||
<p><font size="4"><strong>typedef long LDV_STATUS</strong></font></p>
|
||
|
||
<p><font size="3">The type of LDV functions return code is a 32 bits
|
||
integer. Why? First, because some compilers (e.g., GCC) return a 32 bits
|
||
integer even when specifying a 16 bits integer (short). Secondly, this
|
||
allows for future extensions of the return code in the remaining bits.
|
||
</font></p>
|
||
|
||
<p> </p>
|
||
|
||
<p><a name="ELDV"></a><font size="4"><strong>4.2 Return codes</strong></font></p>
|
||
<div align="center"><center>
|
||
|
||
<table border="2" width="100%">
|
||
<tr>
|
||
<td align="center" width="10%"><strong>Define</strong></td>
|
||
<td align="center" width="75%"><strong>Description</strong></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center" width="10%">ELDV_NOERROR</td>
|
||
<td width="75%">No error. The function worked correctly
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center" width="10%">ELDV_INVALIDPARAMETER</td>
|
||
<td width="75%">At least one of the parameters is not valid</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center" width="10%">ELDV_NBPLANESNOTSUPPORTED</td>
|
||
<td width="75%">The function does not support the number of planes
|
||
passed in parameters</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">ELDV_NOTENOUGHMEMORY</td>
|
||
<td>Not enough memory</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">ELDV_PREVIEWNOTSUPPORTED</td>
|
||
<td>The Preview function is not defined (points to
|
||
NULL)</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">ELDV_RUNNOTSUPPORTED</td>
|
||
<td>The Run function is not defined (points to NULL
|
||
I wonder who would be dumb enough to write an LDV that does
|
||
nothing!</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">ELDV_BADVAPIVERSION</td>
|
||
<td>The available version of <a href="vapi/index.htm#Pr<50>sentation">VAPI</a>
|
||
does not allow to use the LDV (some functions or interfaces
|
||
are missing)</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">ELDV_IMGFORMATMISMATCH</td>
|
||
<td>The image formats handled by the LDV do not allow VISION to
|
||
provide an image compatible with one of the expected formats.
|
||
Normally, the error comes from the LDV.</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">ELDV_GENERALFAILURE</td>
|
||
<td>General failure, reason not specified.</td>
|
||
</tr>
|
||
</table>
|
||
</center></div>
|
||
|
||
<p>These codes can be sent back by LDV functions or by
|
||
<em><strong>VISION</strong></em> to the user to display the corresponding
|
||
error messsage. Think also to use the LDV_SUCCESS macro which indicates
|
||
whether the code passed as a parameter is a success or an error.
|
||
</p>
|
||
|
||
<p> </p>
|
||
|
||
<p><a name="TLDV"></a><font size="4"><strong>4.3 Module types</strong></font></p>
|
||
<div align="center"><center>
|
||
|
||
<table border="2" width="100%">
|
||
<tr>
|
||
<td align="center" width="10%"><strong>Define</strong></td>
|
||
<td align="center" width="75%"><strong>Description</strong></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center" width="10%">TLDV_MODIFYIMG</td>
|
||
<td width="75%">Image modifier module. Can also be used to
|
||
initialise an image by overwriting completely its content, without
|
||
taking into account the current data.</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center" width="10%">TLDV_LOADIMG</td>
|
||
<td width="75%">Image loader module.
|
||
<em><strong>VISION</strong></em>
|
||
does not handle it yet</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center" width="10%">TLDV_SAVEIMG</td>
|
||
<td width="75%">Image saving module. <em><strong>VISION</strong></em>
|
||
does not handle it yet</td>
|
||
</tr>
|
||
</table>
|
||
</center></div>
|
||
|
||
<p> </p>
|
||
|
||
<p><a name="LDVF"></a><font size="4"><strong>4.4 Information on possibilities</strong></font></p>
|
||
<div align="center"><center>
|
||
|
||
<table border="2" width="100%">
|
||
<tr>
|
||
<td align="center" width="10%"><strong>Define</strong></td>
|
||
<td align="center" width="75%"><strong>Description</strong></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center" width="10%">LDVF_STDFORMAT</td>
|
||
<td width="75%">The LDV accepts the standard image format as
|
||
defined by ATARI (bitplanes one after the others). This format is
|
||
not available in True Color.</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center" width="10%">LDVF_ATARIFORMAT</td>
|
||
<td width="75%">The LDV accept ATARI format (interlaced bitplanes
|
||
(ST), Falcon True Color mode)</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">LDVF_SPECFORMAT</td>
|
||
<td>The LDV accepts the specific format of the graphic card</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">LDVF_SUPPORTPREVIEW</td>
|
||
<td>The LDV provides a Preview function (highly recommanded, even
|
||
if it calls Run)</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">LDVF_AFFECTPALETTE</td>
|
||
<td>The LDV modifies the palette (bitplanes modes only). In this
|
||
case, operation on palette must always be done "in
|
||
place". <em><strong>VISION</strong></em> will systematically
|
||
save the palette of the image in the Undo buffer.</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">LDVF_SUPPORTPROG</td>
|
||
<td>The LDV will call function <a
|
||
href="vapi/pr.htm#PrSetProg">PrSetProg</a> of the
|
||
<a href="vapi/index.htm#Pr<50>sentation">VAPI</a> interface
|
||
(recommanded is the process takes more than 2 secondes).
|
||
Before calling <a href="descrip.htm#run">Run</a>, <em><strong>VISION</strong></em>
|
||
will display a progess bar for the LDV and will make it disapear
|
||
afterwards. By calling <a
|
||
href="vapi/pr.htm#PrSetProg">PrSetProg</a> from the
|
||
<a href="vapi/index.htm#Pr<50>sentation">VAPI</a> interface, the LDV
|
||
will be able to inform user on the progress of the process.</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">LDVF_OPINPLACE</td>
|
||
<td>The LDV knows how to work on the source image, without
|
||
<em><strong>VISION</strong></em> having to allocate the
|
||
destination (the transformation is said to occur in place). In
|
||
this case, the out parameter of the <a
|
||
href="descrip.htm#run">Run</a> function is the same as in. As far
|
||
as possible, use this flag, this spares memory. The presence of
|
||
this flag impose obviously that the LDV does not modify the size
|
||
of the image.</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">LDVF_REALTIMEPARAMS</td>
|
||
<td>The LDV does the <a
|
||
href="descrip.htm#run">Run</a> function fast enough in Preview
|
||
mode (small image displayed by the
|
||
<em><strong>VISION</strong></em>) dialog box for the modification
|
||
of the LDV parameters done with the sliders to be smooth enough
|
||
(at least 1 image per second). In this case,
|
||
<em><strong>VISION</strong></em> will call the Prewiew function
|
||
when the user modifies a parameter control slider, without any
|
||
need to press the "Preview" button</td>
|
||
</tr>
|
||
</table>
|
||
</center></div>
|
||
|
||
<p><font size="3">These flags must be combined with the "logical
|
||
or" (|).
|
||
</font></p>
|
||
|
||
<p> </p>
|
||
|
||
<hr>
|
||
<div align="center"><center>
|
||
|
||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||
<tr>
|
||
<td align="center" width="17%"><a href="descrip.htm"><img
|
||
src="images/cprev.jpg" alt="Previous chapter "
|
||
border="0" hspace="2" width="46" height="26"></a><a
|
||
href="index.htm"><img src="images/csom.jpg"
|
||
alt="Back to content " border="0" hspace="2" width="26"
|
||
height="26"></a><a href="struct.htm"><img
|
||
src="images/csuiv.jpg" alt="Next Chapter " border="0"
|
||
hspace="2" width="43" height="26"></a></td>
|
||
<td align="center" valign="top" rowspan="2" width="8%"><p
|
||
align="center"><img src="images/icoprinc.gif" width="59"
|
||
height="71"></p>
|
||
</td>
|
||
<td width="33%"><p align="center"><font color="#0000FF"
|
||
size="5"><strong><em>VISION </em>Documentation
|
||
<em>(LDV)</strong></em></font></p>
|
||
</td>
|
||
<td align="center" valign="top" rowspan="2" width="8%"><p
|
||
align="center"><img src="images/icointro.gif" width="59"
|
||
height="71"></p>
|
||
</td>
|
||
<td valign="top" width="17%"><p align="left">Last update:
|
||
<!--webbot bot="Timestamp" startspan
|
||
s-type="EDITED" s-format="%d/%m/%y" -->29/10/00<!--webbot
|
||
bot="Timestamp" i-checksum="12232" endspan --></p>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="17%"><p align="center"><a
|
||
href="..\..\download/dvldv.zip">Download documentation</a></p>
|
||
</td>
|
||
<td width="33%"><p align="center"><font size="4"><strong>D
|
||
E F I N E S</strong></font></p>
|
||
</td>
|
||
<td valign="top" width="17%"> </td>
|
||
</tr>
|
||
</table>
|
||
</center></div>
|
||
</body>
|
||
</html>
|