Power users hub

From LabRPS Documentation
Revision as of 01:03, 11 June 2024 by LabRPS (talk | contribs) (Created page with " {{TOCright}} 64px ---- This is the place to come if you are an experienced user and want to learn more about customizing and extending LabRPS. LabRPS is extensible by Python code that is run directly in the Python console, or that is loaded from modules at startup. This means that you can modify LabRPS without needing to recompile the program. For example, you can: * '''Create and modify geometry''': you can c...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Power user hub.png


This is the place to come if you are an experienced user and want to learn more about customizing and extending LabRPS.

LabRPS is extensible by Python code that is run directly in the Python console, or that is loaded from modules at startup. This means that you can modify LabRPS without needing to recompile the program. For example, you can:

  • Create and modify geometry: you can create a new object type, either from scratch or by adapting an existing type.
  • Create custom tools and commands: add your own set of tools that run your code.
  • Modify the interface: create toolbars to put your tools, create special windows, panels, or interfaces for interacting with your tools.
  • Modify the scenegraph representation: LabRPS has separate processes for building up the geometry and displaying that geometry on screen. You have full access to the way the scene contents are displayed on screen, therefore you can modify that representation, interact with it, or add custom behaviour to it. You can also add custom screen widgets, like information, draggers, anchors or temporary entities.

If you'd like to contribute content to these pages, request a wiki account with editor permissions in the forum, and read the WikiPages for the general guidelines that you should follow. For other ways to contribute with the project, see the Help LabRPS page.

Customizing LabRPS

Scripting in LabRPS

General

Modules

The functionality of LabRPS is separated in Modules which deal with special data types and applications. LabRPS has built-in modules and Extension Modules (plug-ins). Once plugin modules are installed, they become availible to you as easily as the built-in modules. The modules described below are the default modules, includeed in every LabRPS installation.

  • The Builtin modules are the principal LabRPS modules. They contain tools for manipulating general LabRPS configurations, documents and their contents.
  • Workbench creation shows you how to create your own workbench

Working with Meshes

Working with Parts

Accessing the Coin scenegraph

Controlling the Qt interface

Working with parametric objects

Examples

  • Code snippets : A collection of pieces of LabRPS Python code, to serve as ingredients in your scripts...
  • Line drawing function: How to build a simple tool to draw lines
  • Dialog creation: How to construct dialogs with Qt designer, and use them in LabRPS
  • Embedding LabRPS: How to import LabRPS as a Python module in other applications
  • The Draft Workbench adds basic 2d drawing functions to LabRPS. It is written entirely in Python, so it can be a good example if you want to write your own modules.
  • LabRPS vector math library : A couple of handy functions to manipulate LabRPS vectors. This library is also included in the Draft module.

API Functions

The complete API documentation of LabRPS is located at http://www.labrps.com/api/ . It contains both C++ and Python APIs, and is not totally well formatted yet, which can be confusing when looking for python-only code. An easier to browse version can be found here. Note that it can be incomplete, since it is updated manually. For more accurate information, browse the modules directly from LabRPS's Python console.

Related: Exposing C++ to Python

Advanced modification

Python tutorials

These are good generic tutorials, not specific to LabRPS, that might interest you if you are totally new to python.

Python

PySide - How to create and manage LabRPS's Qt UI interface from python

The following two references are PyQt specific (not PySide) but may offer some information of use:

Pivy - How to interact with LabRPS's 3D scenes

Community projects

On the Community portal, you can find other LabRPS-based projects run by the LabRPS users community. If you are starting a new LabRPS project, be sure to list it there! We also have a page with things you can do if you would like to Help LabRPS.


</translate>