297 lines
14 KiB
HTML
297 lines
14 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html><head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
<meta name="GENERATOR" content="Microsoft FrontPage Express 2.0">
|
|
<title>Documentation VISION (VAPI) : Configuration Interface</title></head>
|
|
<body background="../images/conc2.gif" bgcolor="#ffffff">
|
|
<div align="center"><center>
|
|
|
|
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
|
<tbody><tr>
|
|
<td align="center" width="17%"><a href="lo.htm"><img style="border: 0px solid ; width: 46px; height: 26px;" src="../images/cprev.jpg" alt="Chapitre précédent" hspace="2"></a><a href="index.htm"><img src="../images/csom.jpg" alt="Retour au sommaire" border="0" height="26" hspace="2" width="26"></a><a href="fi.htm"><img style="border: 0px solid ; width: 43px; height: 26px;" src="../images/csuiv.jpg" alt="Chapitre suivant" hspace="2"></a></td>
|
|
<td rowspan="2" align="center" valign="top" width="8%"><p align="center"><img src="../images/icoprinc.gif" height="71" width="59"></p>
|
|
</td>
|
|
<td width="33%"><p align="center"><font color="#0000ff" size="5"><strong>Documentation </strong><em><strong>VISION
|
|
(VAPI)</strong></em></font></p>
|
|
</td>
|
|
<td rowspan="2" align="center" valign="top" width="8%"><p align="center"><img src="../images/icointro.gif" height="71" width="59"></p>
|
|
</td>
|
|
<td valign="top" width="17%"><p align="left">Dernière
|
|
mise à jour : 02/12/20</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="17%"><p align="center"><a href="..%5C..%5C..%5Cdownload/dvldv.zip"><br></a></p>
|
|
</td>
|
|
<td width="33%"><p align="center"><font size="4"><strong>IMAGE INTERFACE</strong></font></p>
|
|
</td>
|
|
<td align="center" width="17%"> </td>
|
|
</tr>
|
|
</tbody></table>
|
|
</center></div>
|
|
|
|
<hr>
|
|
<div align="center"><center>
|
|
|
|
<table border="2" width="100%">
|
|
<tbody><tr>
|
|
<td colspan="2" align="center"><strong>Summary</strong></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Interface prefix</strong></td>
|
|
<td width="85%">Im</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Number of functions</strong></td>
|
|
<td width="85%">7</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Description</strong></td>
|
|
<td width="85%">Set of functions to manage images files</td>
|
|
</tr>
|
|
</tbody></table>
|
|
</center></div>
|
|
|
|
<p> </p>
|
|
<div align="center"><center>
|
|
|
|
<table border="2" width="100%">
|
|
<tbody><tr>
|
|
<td width="15%"><a name="ImGetInf"></a><strong>Prototype</strong></td>
|
|
<td width="85%">long cdecl <span style="font-weight: bold;">ImGetInf</span>(char* filename, void* ldv_img)</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Parameters</strong></td>
|
|
<td width="85%">filename: name of the image file<br>ldv_img: pointer to a LDV_IMAGE structure</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Return</strong></td>
|
|
<td width="85%">LDV_STATUS</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Description</strong></td>
|
|
<td width="85%">Reads
|
|
informatiuons from the file and fills in the LDV_IMAGE strucutre. Image
|
|
is not loaded (see next function) but all image caracteristics such as
|
|
width, height, number of planes, ... are fetched.</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Comments</strong></td>
|
|
<td width="85%">Call <span style="font-weight: bold;">ImFree</span> to free related resources<br></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Version VAPI</strong></td>
|
|
<td width="85%">1.09 or more</td>
|
|
</tr>
|
|
</tbody></table>
|
|
</center></div>
|
|
|
|
<p> </p>
|
|
<div align="center"><center>
|
|
|
|
<table border="2" width="100%">
|
|
<tbody><tr>
|
|
<td width="15%"><a name="LoGetLogLevel"></a><strong>Prototype</strong></td>
|
|
<td width="85%">long cdecl <span style="font-weight: bold;">ImLoad</span>(void* ldv_img)</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Parameters</strong></td>
|
|
<td width="85%">ldv_img: pointer to LDV_IMAGE structure previously filled-in by <span style="font-weight: bold;">ImGetInf</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Return</strong></td>
|
|
<td width="85%">LDV_STATUS<em><strong></strong></em></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Description</strong></td>
|
|
<td width="85%">Loads the image into memory</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Comments</strong></td>
|
|
<td width="85%">Image data is read during this call</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Version VAPI</strong></td>
|
|
<td width="85%">1.09 or more</td>
|
|
</tr>
|
|
</tbody></table>
|
|
</center></div>
|
|
|
|
<p> </p>
|
|
<div align="center"><center>
|
|
|
|
<table border="2" width="100%">
|
|
<tbody><tr>
|
|
<td width="15%"><a name="LoGetLogLevel"></a><strong>Prototype</strong></td>
|
|
<td width="85%">void cdecl <span style="font-weight: bold;">ImFree</span>(void* ldv_img)</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Parameters</strong></td>
|
|
<td width="85%">ldv_img: pointer to LDV_IMAGE structure previously filled-in by <span style="font-weight: bold;">ImGetInf</span><span style="font-weight: bold;"></span></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Return</strong></td>
|
|
<td width="85%">None<em><strong></strong></em></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Description</strong></td>
|
|
<td width="85%">Frees resources allocated by <span style="font-weight: bold;">ImGetInf</span> and <span style="font-weight: bold;">ImLoad</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Comments</strong></td>
|
|
<td width="85%">.</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Version VAPI</strong></td>
|
|
<td width="85%">1.09 or more</td>
|
|
</tr>
|
|
</tbody></table>
|
|
</center></div><br><div align="center"><center>
|
|
|
|
<table border="2" width="100%">
|
|
<tbody><tr>
|
|
<td width="15%"><a name="LoGetLogLevel"></a><strong>Prototype</strong></td>
|
|
<td width="85%">long cdecl <span style="font-weight: bold;">ImSave</span>(char* filename, void* ldv_img, char* save_options) ;</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Parameters</strong></td>
|
|
<td width="85%">filename: name of file to save image<br>ldv_img: LDV_IMAGE structure defining image to save<br>save_options: standard options, separated by '';',(option=<value>):<br>fmt = <3 characters defining image format><br>quality=<quality 0...100> (JPEG)<br>flipflop=<0 ou 2> (0: no flip-flop, 2: Y flip-flop) (TGA)<br>compression=<none or lzw> (TIF)<br>byteorder=<motorola or intel> (TIF)</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Return</strong></td>
|
|
<td width="85%">LDV_STATUS<em><strong></strong></em></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Description</strong></td>
|
|
<td width="85%">Saves an image residing in memory to a file</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Comments</strong></td>
|
|
<td width="85%">Example<br>status = Vapi->ImSave( "h:\\test.tif", ldv_img, "fmt=TIF;compression=LZW;byteorder=motorola" ) ;<br>Some options depend on the format; they may be ignored by the driver in charge of saving<br>Check out opnsav.vcs script for an example on the options</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Version VAPI</strong></td>
|
|
<td width="85%">1.09 or more</td>
|
|
</tr>
|
|
</tbody></table>
|
|
</center></div>
|
|
|
|
<p> </p>
|
|
<div align="center"><center>
|
|
|
|
<table border="2" width="100%">
|
|
<tbody><tr>
|
|
<td width="15%"><a name="LoGetLogLevel"></a><strong>Prototype</strong></td>
|
|
<td width="85%">long cdecl <span style="font-weight: bold;">ImDither</span>(long method, long param, void* ldv_img_in, void* ldv_img_out)</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Parameters</strong></td>
|
|
<td width="85%">method: dither method to use:<br><div style="margin-left: 40px;"><ul><li>0: Auto, let <span style="font-weight: bold; font-style: italic;">VISION</span> decide</li><li>1: monochrome mattrix</li><li>2: grey level</li><li>3: 216 colors</li><li>4: dual-tone</li></ul></div>ldv_img_in: LDV_IMAGE structure usually provided by <span style="font-weight: bold; font-style: italic;">VISION<br></span>ldv_img_out: LDV_IMAGE structure holding dithered image<span style="font-weight: bold; font-style: italic;"></span></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Return</strong></td>
|
|
<td width="85%">LDV_STATUS<em><strong></strong></em></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Description</strong></td>
|
|
<td width="85%">Request <span style="font-weight: bold; font-style: italic;">VISION</span> to dither an image using a method<br>Output number of planes shall be stated in variable out->Raster.fd_nplanes (1,4,8,16 ou32)<span style="font-weight: bold;"></span></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Comments</strong></td>
|
|
<td width="85%"></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Version VAPI</strong></td>
|
|
<td width="85%">1.09 or more</td>
|
|
</tr>
|
|
</tbody></table>
|
|
</center></div>
|
|
|
|
<p></p>
|
|
<div align="center"><center>
|
|
|
|
<table border="2" width="100%">
|
|
<tbody><tr>
|
|
<td width="15%"><a name="LoGetLogLevel"></a><strong>Prototype</strong></td>
|
|
<td width="85%">long cdecl <span style="font-weight: bold;">ImGetStdData</span>(void* ldv_img, char* query, char* out_data, long out_data_size) ;</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Parameters</strong></td>
|
|
<td width="85%">ldv_img: pointer to LDV_IMAGE structure previously filled-in by <span style="font-weight: bold;">ImGetInf</span><span style="font-weight: bold;"><br></span>query: string to request standard atribute which list follows:<br><div style="margin-left: 40px;"><ul><li>filename: filename passed to <span style="font-weight: bold;">ImGetInf</span></li></ul></div>out_data: string holding value of the requested attribute<br>out_data_size: size, in bytes, of out_data buffer<span style="font-weight: bold;"></span></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Return</strong><strong></strong></td>
|
|
<td width="85%">LDV_STATUS<em><strong></strong></em></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Description</strong></td>
|
|
<td width="85%">Requests standard data on an image</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Comments</strong></td>
|
|
<td width="85%">See optimg.ldv source code</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Version VAPI</strong></td>
|
|
<td width="85%">1.09 or more</td>
|
|
</tr>
|
|
</tbody></table>
|
|
</center></div>
|
|
|
|
<p></p><div align="center"><center>
|
|
|
|
<table border="2" width="100%">
|
|
<tbody><tr>
|
|
<td width="15%"><a name="LoGetLogLevel"></a><strong>Prototype</strong></td>
|
|
<td width="85%">long cdecl <span style="font-weight: bold;">ImComputeHistogram</span>(void* ldv_img, HISTO *histo) ;</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Parameters</strong></td>
|
|
<td width="85%">ldv_img: LDV_IMAGE structure defining image to compute histograms<br>histo: pointeur to a HISTO structure containing the result<span style="font-weight: bold;"></span></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Return</strong></td>
|
|
<td width="85%">LDV_STATUS<em><strong></strong></em></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Description</strong></td>
|
|
<td width="85%">Requests <span style="font-weight: bold; font-style: italic;">VISION</span> to compute histograms</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Remarques</strong></td>
|
|
<td width="85%">.histo->norm shall be initialized to tell <span style="font-weight: bold; font-style: italic;">VISION</span> what is the maximal value for the highest repetition frequency<br>See optimg.ldv source code </td>
|
|
</tr>
|
|
<tr>
|
|
<td width="15%"><strong>Version VAPI</strong></td>
|
|
<td width="85%">1.09 or more</td>
|
|
</tr>
|
|
</tbody></table>
|
|
</center></div><br><p></p><p></p><p></p>
|
|
<div align="center"><center><br></center></div>
|
|
|
|
<hr>
|
|
<div align="center"><center>
|
|
|
|
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
|
<tbody><tr>
|
|
<td align="center" width="17%"><a href="lo.htm"><img style="border: 0px solid ; width: 46px; height: 26px;" src="../images/cprev.jpg" alt="Chapitre précédent" hspace="2"></a><a href="index.htm"><img src="../images/csom.jpg" alt="Retour au sommaire" border="0" height="26" hspace="2" width="26"></a><a href="fi.htm"><img style="border: 0px solid ; width: 43px; height: 26px;" src="../images/csuiv.jpg" alt="Chapitre suivant" hspace="2"></a></td>
|
|
<td rowspan="2" align="center" valign="top" width="8%"><p align="center"><img src="../images/icoprinc.gif" height="71" width="59"></p>
|
|
</td>
|
|
<td width="33%"><p align="center"><font color="#0000ff" size="5"><strong>Documentation </strong><em><strong>VISION
|
|
(VAPI)</strong></em></font></p>
|
|
</td>
|
|
<td rowspan="2" align="center" valign="top" width="8%"><p align="center"><img src="../images/icointro.gif" height="71" width="59"></p>
|
|
</td>
|
|
<td valign="top" width="17%"><p align="left"><br></p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="17%"><p align="center"><a href="..%5C..%5C..%5Cdownload/dvldv.zip"><br></a></p>
|
|
</td>
|
|
<td width="33%"><p align="center"><font size="4"><strong>IMAGE </strong></font><font size="4"><strong>INTERFACE</strong></font></p>
|
|
</td>
|
|
<td valign="top" width="17%"> </td>
|
|
</tr>
|
|
</tbody></table>
|
|
</center></div>
|
|
</body></html> |