| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  | /*
 | 
					
						
							| 
									
										
										
										
											2008-01-07 18:03:41 +00:00
										 |  |  |  * ***** BEGIN GPL LICENSE BLOCK ***** | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  |  * | 
					
						
							|  |  |  |  * This program is free software; you can redistribute it and/or | 
					
						
							|  |  |  |  * modify it under the terms of the GNU General Public License | 
					
						
							|  |  |  |  * as published by the Free Software Foundation; either version 2 | 
					
						
							| 
									
										
										
										
											2008-01-07 19:13:47 +00:00
										 |  |  |  * of the License, or (at your option) any later version. | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  |  * | 
					
						
							|  |  |  |  * This program is distributed in the hope that it will be useful, | 
					
						
							|  |  |  |  * but WITHOUT ANY WARRANTY; without even the implied warranty of | 
					
						
							|  |  |  |  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the | 
					
						
							|  |  |  |  * GNU General Public License for more details. | 
					
						
							|  |  |  |  * | 
					
						
							|  |  |  |  * You should have received a copy of the GNU General Public License | 
					
						
							|  |  |  |  * along with this program; if not, write to the Free Software Foundation, | 
					
						
							| 
									
										
										
										
											2010-02-12 13:34:04 +00:00
										 |  |  |  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  |  * | 
					
						
							| 
									
										
										
										
											2011-10-31 06:13:20 +00:00
										 |  |  |  * Contributor(s): Michel Selten, | 
					
						
							|  |  |  |  *                 Willian P. Germano, | 
					
						
							|  |  |  |  *                 Chris Keith, | 
					
						
							|  |  |  |  *                 Campbell Barton | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  |  * | 
					
						
							| 
									
										
										
										
											2008-01-07 18:03:41 +00:00
										 |  |  |  * ***** END GPL LICENSE BLOCK ***** | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  |  */ | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2011-02-21 06:58:46 +00:00
										 |  |  | /** \file BPY_extern.h
 | 
					
						
							|  |  |  |  *  \ingroup python | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2012-02-17 18:59:41 +00:00
										 |  |  | #ifndef __BPY_EXTERN_H__
 | 
					
						
							|  |  |  | #define __BPY_EXTERN_H__
 | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | struct Text; /* defined in DNA_text_types.h */ | 
					
						
							|  |  |  | struct ID; /* DNA_ID.h */ | 
					
						
							|  |  |  | struct Object; /* DNA_object_types.h */ | 
					
						
							| 
									
										
										
										
											2009-02-15 23:28:30 +00:00
										 |  |  | struct ChannelDriver; /* DNA_anim_types.h */ | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  | struct ListBase; /* DNA_listBase.h */ | 
					
						
							|  |  |  | struct bConstraint; /* DNA_constraint_types.h */ | 
					
						
							|  |  |  | struct bPythonConstraint; /* DNA_constraint_types.h */ | 
					
						
							|  |  |  | struct bConstraintOb; /* DNA_constraint_types.h */ | 
					
						
							|  |  |  | struct bConstraintTarget; /* DNA_constraint_types.h*/ | 
					
						
							| 
									
										
										
										
											2008-12-21 10:36:29 +00:00
										 |  |  | struct bContext; | 
					
						
							| 
									
										
										
										
											2009-11-10 16:18:54 +00:00
										 |  |  | struct bContextDataResult; | 
					
						
							| 
									
										
										
										
											2009-06-22 18:19:18 +00:00
										 |  |  | struct ReportList; | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  | #ifdef __cplusplus
 | 
					
						
							|  |  |  | extern "C" { | 
					
						
							|  |  |  | #endif
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2011-01-05 02:08:54 +00:00
										 |  |  | void BPY_pyconstraint_exec(struct bPythonConstraint *con, struct bConstraintOb *cob, struct ListBase *targets); | 
					
						
							| 
									
										
										
										
											2009-11-20 15:01:09 +00:00
										 |  |  | //	void BPY_pyconstraint_settings(void *arg1, void *arg2);
 | 
					
						
							| 
									
										
										
										
											2011-01-05 02:08:54 +00:00
										 |  |  | void BPY_pyconstraint_target(struct bPythonConstraint *con, struct bConstraintTarget *ct); | 
					
						
							|  |  |  | void BPY_pyconstraint_update(struct Object *owner, struct bConstraint *con); | 
					
						
							|  |  |  | int BPY_is_pyconstraint(struct Text *text); | 
					
						
							| 
									
										
										
										
											2009-11-20 15:01:09 +00:00
										 |  |  | //	void BPY_free_pyconstraint_links(struct Text *text);
 | 
					
						
							| 
									
										
										
										
											2011-10-31 06:13:20 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2011-02-19 12:05:20 +00:00
										 |  |  | void BPY_python_start(int argc, const char **argv); | 
					
						
							| 
									
										
										
										
											2011-06-02 08:29:16 +00:00
										 |  |  | void BPY_python_end(void); | 
					
						
							| 
									
										
										
										
											2013-06-09 23:31:53 +00:00
										 |  |  | void BPY_python_reset(struct bContext *C); | 
					
						
							| 
									
										
										
										
											2010-05-30 14:05:58 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2013-12-17 18:44:56 +11:00
										 |  |  | 
 | 
					
						
							|  |  |  | /* global interpreter lock */ | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | typedef void *BPy_ThreadStatePtr; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | BPy_ThreadStatePtr BPY_thread_save(void); | 
					
						
							|  |  |  | void BPY_thread_restore(BPy_ThreadStatePtr tstate); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* our own wrappers to Py_BEGIN_ALLOW_THREADS/Py_END_ALLOW_THREADS */ | 
					
						
							|  |  |  | #define BPy_BEGIN_ALLOW_THREADS { BPy_ThreadStatePtr _bpy_saved_tstate = BPY_thread_save(); (void)0
 | 
					
						
							|  |  |  | #define BPy_END_ALLOW_THREADS BPY_thread_restore(_bpy_saved_tstate); } (void)0
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2011-01-05 02:08:54 +00:00
										 |  |  | /* 2.5 UI Scripts */ | 
					
						
							|  |  |  | int		BPY_filepath_exec(struct bContext *C, const char *filepath, struct ReportList *reports); | 
					
						
							| 
									
										
										
										
											2013-01-07 05:26:12 +00:00
										 |  |  | int		BPY_text_exec(struct bContext *C, struct Text *text, struct ReportList *reports, const bool do_jump); | 
					
						
							| 
									
										
										
										
											2011-01-05 02:08:54 +00:00
										 |  |  | void	BPY_text_free_code(struct Text *text); | 
					
						
							|  |  |  | void	BPY_modules_update(struct bContext *C); // XXX - annoying, need this for pointers that get out of date
 | 
					
						
							|  |  |  | void	BPY_modules_load_user(struct bContext *C); | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2011-11-03 06:53:52 +00:00
										 |  |  | void	BPY_app_handlers_reset(const short do_all); | 
					
						
							| 
									
										
										
										
											2011-06-24 16:54:30 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2011-01-05 02:08:54 +00:00
										 |  |  | void	BPY_driver_reset(void); | 
					
						
							| 
									
										
										
										
											2011-11-17 07:08:09 +00:00
										 |  |  | float	BPY_driver_exec(struct ChannelDriver *driver, const float evaltime); | 
					
						
							| 
									
										
										
										
											2011-01-05 02:08:54 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2014-01-04 17:16:19 +11:00
										 |  |  | int		BPY_button_exec(struct bContext *C, const char *expr, double *value, const bool verbose); | 
					
						
							| 
									
										
										
										
											2011-01-05 02:08:54 +00:00
										 |  |  | int		BPY_string_exec(struct bContext *C, const char *expr); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | void	BPY_DECREF(void *pyob_ptr);	/* Py_DECREF() */ | 
					
						
							| 
									
										
										
										
											2012-10-26 10:54:02 +00:00
										 |  |  | void	BPY_DECREF_RNA_INVALIDATE(void *pyob_ptr); | 
					
						
							| 
									
										
										
										
											2011-01-05 02:08:54 +00:00
										 |  |  | int		BPY_context_member_get(struct bContext *C, const char *member, struct bContextDataResult *result); | 
					
						
							|  |  |  | void	BPY_context_set(struct bContext *C); | 
					
						
							| 
									
										
										
										
											2012-05-08 22:07:06 +00:00
										 |  |  | void	BPY_context_update(struct bContext *C); | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2011-03-01 09:02:54 +00:00
										 |  |  | void	BPY_id_release(struct ID *id); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
											  
											
												Python i18n API. Many thanks to Campbell and Brecht for the reviews and suggestions!
This commit adds:
* A new bpy.app.translations module giving some info about locales/translation stuff (current active locale, all locales currently known by blender, all translation contexts currently defined, etc.).
* The ability for addons to feature translations, using the (un)register functions of above module.
* Also cleans up "translate py string when storing into RNA prop" by removing "PROP_TRANSLATE" string's subtype, and adding a PROP_STRING_PY_TRANSLATE flag instead (this way it is no more exposed to python...).
Addon translations work with py dictionaries: each addon features a dict {lang: {(context, message): translation, ...}, ...}, which is registered when the addon is enabled (and unregistered when disabled). 
Then, when a key (context, message) is not found in regular mo catalog, a cache dict for current locale is built from all registered addon translations, and key is searched in it.
Note: currently addons writers have to do all the work by hand, will add something (probably extend "edit translation" addon) to automate messages extraction from addons soon(ish)! To get a look to expected behavior from addons, have a look at render_copy_settings/__init__.py and render_copy_settings/translations.py (rather stupid example currently, but...). Once we have a complete process, I'll also update relevant wiki pages.
											
										 
											2013-01-20 17:29:07 +00:00
										 |  |  | /* I18n for addons */ | 
					
						
							|  |  |  | #ifdef WITH_INTERNATIONAL
 | 
					
						
							|  |  |  | const char *BPY_app_translations_py_pgettext(const char *msgctxt, const char *msgid); | 
					
						
							|  |  |  | #endif
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2007-12-24 18:53:37 +00:00
										 |  |  | #ifdef __cplusplus
 | 
					
						
							|  |  |  | }				/* extern "C" */ | 
					
						
							|  |  |  | #endif
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2012-02-17 18:59:41 +00:00
										 |  |  | #endif  /* __BPY_EXTERN_H__ */
 |