<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
Thanks<br>
That was a great help.<br>
<br>
I was looking in the trunk of the svn and
source/blender/python/api2_2x/doc/ does not exist.<br>
<br>
But since you told me what I was looking for, I started working through
the tags and found it right away.<br>
<br>
If you look at the API description to Text3d<br>
<a class="moz-txt-link-freetext" href="http://www.blender.org/documentation/249PythonDoc/">http://www.blender.org/documentation/249PythonDoc/</a><br>
<br>
It says:<br>
<p>This module provides access to <b>Font</b> objects in Blender.</p>
<p>Example:</p>
<pre class="literalblock"> import Blender
from Blender import Curve, Object, Scene, Text3d
txt = Text3d.New("MyText") # create a new Text3d object called MyText
scn = Scene.GetCurrent() # get current scene
ob = scn.objects.new(txt) # create an object from the obdata in the current scene
ob.makeDisplayList() # rebuild the display list for this object
Window.RedrawAll()
</pre>
<br>
This is really not helpful.<br>
What ##*&* is a "Font" object? That is not a term that a normal
person would use to describe what you get. "Access" is only part of
what it does. It also enables you to create new ones.<br>
<br>
According to the rest of the page there are only 2 functions "New" and
"get".<br>
<br>
I find it hard to believe that the rest of the Text3d functions are
deprecated.<br>
<br>
A quick look at the sources shows that there are more functions with
descriptions. Why are they not showing up in the documentation?<br>
<br>
The example would be a lot more hellpful if it actually showed how to
get the text that you want into your scene. <br>
I would also change the comments to relate a bit better to what the
user wants to do not some unrelated discussion of internal functioning.<br>
"obdata" is not defined or referenced in the documentation.<br>
<br>
<pre> import Blender</pre>
<pre> from Blender import Curve, Object, Scene, Text3d</pre>
<pre> txt = Text3d.New("MyText") # create a new Text3d object called MyText</pre>
<pre> txt.setText("Words I want on the scene") # associate the text "Words I want on the scene" with the text object</pre>
<pre> scn = Scene.GetCurrent() # get current scene</pre>
<pre> ob = scn.objects.new(txt) # create an object saying "Words I want on the scene" in the current scene</pre>
<pre> ob.makeDisplayList() # rebuild the display list for this object - WHY??? DO I ALWAYS NEED TO DO THIS WITH Text3d?
Window.RedrawAll()
</pre>
<br>
<br>
I realize that documentation is hard to write for programmers since
they are frequently too knowledgeable to understand what has to be
explained and are often not application oriented.<br>
Adding second language issues does not make it better.<br>
<br>
<br>
How can I fix the source so that the Text3D description:<br>
- has a useful example - once I figure out how, I would add the setting
of the string (as above) and changing the font, the size, the
alignment, orientation and perhaps even show it being extruded.<br>
- describes where the object appears on the screen and how to change
its orientation and location<br>
- has ALL the non-deprecated functions listed and the deprecated
function listed with a note that it is deprecated.<br>
<br>
Why are the rest of the functions not showing up in the documentation?
They seem to actually have descriptions. It is hard to use objects with
most of the methods and properties undocumented.<br>
<br>
<br>
Ron<br>
<br>
<br>
<br>
Nery Chucuy wrote:
<blockquote
cite="mid:b199cb620910050814k3b5256b5o45def2de366cc406@mail.gmail.com"
type="cite">
<div><br>
<div class="gmail_quote">2009/10/5 Ron Wheeler <span dir="ltr"><<a
moz-do-not-send="true" href="mailto:rwheeler@artifact-software.com">rwheeler@artifact-software.com</a>></span><br>
<blockquote class="gmail_quote"
style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div bgcolor="#ffffff" text="#000000">...<br>
Any idea about where to find the sources for the documentation?<br>
I would not mind putting some effort into fixing things where I can.<br>
<br>
</div>
</blockquote>
<div><br>
</div>
<div>At least on 2.4x python api documentation is on the folder:</div>
<div><br>
</div>
<div>source/blender/python/api2_2x/doc/</div>
<div> </div>
<div>However I don't think it worth for 2.4x maybe you can help to do
that on 2.5.About that you can ask to Campbell Barton ( ideasman on
IRC).</div>
<div><br>
</div>
<div>Regards,</div>
<div><br>
</div>
<div>Nery Chucuy (idesisnery)</div>
</div>
</div>
<pre wrap="">
<hr size="4" width="90%">
_______________________________________________
Bf-python mailing list
<a class="moz-txt-link-abbreviated" href="mailto:Bf-python@blender.org">Bf-python@blender.org</a>
<a class="moz-txt-link-freetext" href="http://lists.blender.org/mailman/listinfo/bf-python">http://lists.blender.org/mailman/listinfo/bf-python</a>
</pre>
</blockquote>
<br>
</body>
</html>