summaryrefslogtreecommitdiff
path: root/html/en/drv/picture.html
blob: d70255550d398fc48d941da4dd2597d3fc01e88a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
<!doctype HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>

<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>CD_METAFILE</title>
<link rel="stylesheet" type="text/css" href="../../style.css">
</head>

<body>

<h2>CD_PICTURE - CD Picture (cdpicture.h)</h2>

  <p>This driver allows the creation of a CD Picture. It store primitives and 
  attributes in memory that can be played and resized in any other driver. It 
  does not includes clipping and WriteMode.</p>

<h3>Use</h3>

  <p>The file is created by calling function <font face="Courier">
  <a href="../func/init.html#cdCreateCanvas"><strong>cdCreateCanvas</strong></a>(CD_PICTURE, 
  Data)</font>. The <font face="Courier">Data</font> parameter is a string that 
  can contain the resolution in the following format:</p>
  
    <pre>&quot;[resolution]&quot; or in <em>C use &quot;<strong><tt>%lg</tt></strong>&quot;</em></pre>
  
  <p><font face="Courier">Resolution </font>is the number of pixels per millimeter; its default value is 
  &quot;3.78 pixels/mm&quot; (96 DPI).</p>
<p>The canvas size is automatically calculated to be the bounding box of all the 
primitives inside the picture.</p>
  <p>Any amount of such canvases may exist simultaneously. It is important to note that a call to function
  <a href="../func/init.html#cdKillCanvas"><font face="Courier"><strong>
  cdKillCanvas</strong></font></a> is required to release the picture memory.</p>

<h3>Behavior of Functions</h3>
<h4>Coordinate System and Clipping </h4>
<ul>
  <li><a href="../func/other.html#cdPlay">
  <font face="Courier"><strong>Play</strong></font></a>: implemented. </li>
  <li><a href="../func/coordinates.html#cdUpdateYAxis"><font face="Courier">
  <strong>UpdateYAxis</strong></font></a>: does nothing.</li>
  <li><b><strong>Clipping</strong>:</b> not supported.</li>
  <li><strong>Transformation Matrix</strong>: not supported.</li>
  <li><a href="../func/coordinates.html#cdGetCanvasSize">cdGetCanvasSize</a>: 
  returns the size of the bounding box that includes all primitives inside the 
  picture.</li>
</ul>
<h4>Attributes</h4>
<dir>
  <li><a href="../func/attributes.html#cdWriteMode"><font face="Courier">
  <strong>
  WriteMode</strong></font></a>: does nothing.</li>
  <li><a href="../func/text.html#cdFontDim"><font face="Courier"><strong>FontDim</strong></font></a>: 
  uses a size estimator, returning approximate values.</li>
  <li><a href="../func/text.html#cdTextSize"><font face="Courier"><strong>
  TextSize</strong></font></a>: uses a size estimator, returning approximate values.</li>
</dir>
<h4>Colors</h4>
<ul>
  <li><a href="../func/color.html#cdGetColorPlanes"><font face="Courier">
  <strong>
  GetColorPlanes</strong></font></a>: always returns 24.</li>
</ul>
<h4>Primitives</h4>
<ul>
  <li>Floating point primitives are supported.</li>
</ul>
<h4>Client Images</h4>
<ul>
  <li><a href="../func/client.html#cdGetImageRGB"><font face="Courier"><strong>
  GetImageRGB</strong></font></a>: does nothing.</li>
</ul>
<h4>Server Images</h4>
<ul>
  <li>All functions do nothing.</li>
</ul>

</body>

</html>