Welcome to mirror list, hosted at ThFree Co, Russian Federation.

Font.py « doc « api2_2x « python « blender « source - git.blender.org/blender.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
blob: 44fa3d81f91b3e6da93004650f441786ade96df8 (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
# Blender.Text3d.Font module and the Font PyType object

"""
The Blender.Text3d.Font subsubmodule.

Text3d.Font Objects
===================

This module provides access to B{Font} objects in Blender.

Example::
	import Blender
	from Blender import Text3d
	
	# Load a font
	myfont= Text3d.Font.Load('/usr/share/fonts/ttf/verdana.ttf')
	
	# 
	for font in Text3d.Font.Get():
		print font.name, font.filename, font.packed
"""

def Load (filename):
	"""
	Create a new Text3d.Font object.
	@type filename: string
	@param filename: file of the font
	@rtype: Blender Text3d.Font
	@return: The created Text3d.Font Data object.
	"""

def Get (name = None):
	"""
	Get the Text3d.Font object(s) from Blender.
	@type name: string
	@param name: The name of the Text3d object.
	@rtype: Blender Text3d or a list of Blender Text3ds
	@return: It depends on the 'name' parameter:
			- (name): The Text3d object with the given name;
			- ():     A list with all Font objects in the current .blend file.
	"""
class Font:
	"""
	The Text3d.Font object
	======================
		This object gives access  Blender's B{Font} objects
	@ivar filename: The filename (path) of the file loaded into this Font.
	@type filename: string
	@ivar packed: Boolean, True when the sample is packed (readonly).
	@type packed: string
	"""

	def pack():
		"""
		Packs the font into the current blend file.
		@note: 
		@returns: nothing
		@rtype: none
		"""

	def unpack(mode):
		"""
		Unpacks the font.
		@param mode: One of the values in Blender.UnpackModes dict.
		@note: An error will be raised if the font is not packed or the filename path does not exist.
		@returns: nothing
		@rtype: none
		@type mode: int
		"""