222 lines
5.6 KiB
HTML
Raw Normal View History

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>RoboFab Objects: RSegment</title>
<link href="../default.css" type="text/css" rel="stylesheet" />
</head>
<body>
<div id="modellogo">
<img src="../img/drawmodel_header.jpg" width="595" height="112" />
</div>
<div class="leftcontent">
<h2 class="crb-seealso">
RoboFab
</h2>
<p class="menu">
<a href="../index.html">
Home
</a>
<br />
<a href="../download/license.html">
Download v1.1.1
</a>
<br />
<a href="../intro.html">
Intro
</a>
<br />
<a href="../install.html">
Install Notes
</a>
<br />
<a href="../history.html">
History
</a>
<br />
<a href="../executive.html">
Summary
</a>
</p>
<p class="menu">
<a href="../howto/index.html">
How to's
</a>
<br />
<a href="index.html">
Fab Objects
</a>
<br />
<a href="model.html">
Fab Map
</a>
<br />
<a href="../tools/index.html">
Fab Tools
</a>
<br />
<a href="../ufo/index.html">
UFO Overview
</a>
<br />
<a href="../limitations.html">
Fab Limitations
</a>
</p>
<p class="menu">
<a href="../links/index.html">
Links
</a>
<br />
<a href="../glossary/index.html">
Glossary
</a>
<br />
<a href="../credits.html">
Credits
</a>
</p>
<br />
<br />
<p class="crb-uplink"><a href="index.html">Back to Objects</a></p>
<br />
<br />
<p class="menu">
<a href="../howto/understandcontours.html">Understanding Contours</a><br />
<a href="../howto/usetransformations.html">Using transformations</a><br />
<a href="anchor.html">RAnchor</a><br />
<a href="bpoint.html">bPoint</a><br />
<a href="component.html">RComponent</a><br />
<a href="contour.html">RContour</a><br />
<a href="font.html">RFont</a><br />
<a href="glyph.html">RGlyph</a><br />
<a href="index.html">Objects</a><br />
<a href="info.html">RInfo</a><br />
<a href="kerning.html">RKerning</a><br />
<a href="lib.html">RLib</a><br />
<a href="model.html">Object model</a><br />
<a href="pen.html">Pen objects</a><br />
<a href="point.html">RPoint</a><br />
</p>
</div>
<div class="footer">
<a href="../feedback.html">
Feedback
</a>
<br />
<a href="../map.html">
Sitemap
</a>
<br />
Please also refer to the
<a href="../download/license.html">
Legal
</a>
<br />
Copyright 2003-2005 RoboFab
<br />
version 1.1.1
</div>
<div id="titlepic">
<img src="../img/offdrawmodel_34.gif" alt="" border="0" />
</div>
<div class="content">
<h1>RoboFab RSegment</h1>
<h3>Usage</h3>
<pre>f = OpenFont()
for c in f:
for contour in c:
for segment in contour:
print segment
>>> < RSegment for RoboFab Demo Font.R[0][0] >
< RSegment for RoboFab Demo Font.R[0][1] >
< RSegment for RoboFab Demo Font.R[0][2] >
< RSegment for RoboFab Demo Font.R[0][3] >
< RSegment for RoboFab Demo Font.R[0][4] >
</pre>
<h3>Description</h3>
<p>
A Contour object is a list of segments. A segment is a list of points with some special attributes and methods. See the LettError wiki for a <a href="http://just.letterror.com/ltrwiki/SegmentsVersusPoints">comprehensive explanation of segments</a>.
</p>
<h3>Understanding Contours and outlines</h3>
<p>
The way outline data is organised in RoboFab, and how the various objects relate is described here: <a href="../howto/understandcontours.html">understanding contours</a>.
</p>
<h3>Attributes</h3>
<ul>
<li>
<strong>type</strong>: Type of segment
</li>
<li>
<strong>smooth</strong>: True if the segment is smooth, False if not.
</li>
<li>
<strong>selected</strong>: Returns True if the segment is selected, False if not.
</li>
<li>
<strong>points</strong>: List of points in the segment.
</li>
<li>
<strong>onCurve</strong>: Returns the oncurve point associated with the segment.
</li>
<li>
<strong>offCurve</strong>: Returns a list of offcurve points associated with the segment.
</li>
</ul>
<h3>Attribute examples</h3>
<pre>f = OpenFont()
for c in f:
for contour in c:
for segment in contour:
print len(segment)
print segment.type
print segment.smooth
print segment.points
print segment.onCurve
print segment.offCurve
print segment.selected
</pre>
<h3>Methods</h3>
<p>
</p>
<ul>
<li><strong>copy()</strong>: return a deepcopy of the object.</li>
<li><strong>move((x, y))</strong>: move the anchor of the bPoint to (x,y). The relative coordinates of the bcpIn and bcpOut will remain the same, which means that in fact, they move the same distance.</li>
<li><strong>round()</strong>: round the coordinates to whole integers.</li>
<li><strong>transform(matrix)</strong>: Transform this point. Use a Transform matrix
object to mess with the point. <a href="../howto/usetransformations.html">See how to use transformations</a>.</li>
</ul>
<h3>Method examples</h3>
<pre>f = OpenFont()
for c in f:
for contour in c:
for segment in contour:
segment.move((50, 25))
</pre>
</div>
</body>
</html>