File: README.md

package info (click to toggle)
sight 25.2.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 42,180 kB
  • sloc: cpp: 289,476; xml: 17,257; ansic: 9,878; python: 1,379; sh: 144; makefile: 33
file content (47 lines) | stat: -rw-r--r-- 2,628 bytes parent folder | download
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
# sight::service

This is one of the most important libraries in _Sight_. It defines extension points for _appConfig_:
- **factory**: allows to define new services.
- **config**: application configuration that describe a set of data, services and connections. **This is the main way to create applications in _Sight_.**
- **parameters**: allows to pass parameters to an config instance, when launched by the app module.

## Classes

### Services

The library proposes different base classes to implement services. They bring a semantic on top of `IService`, which allows to query services that match an interface.

- **controller**: generic interface meant to define control services
- **object_parser**: generic interface meant to define services which build objects or associated services from an XML-based description
- **config_launcher**: starts/stops a template configuration

### _extension_

- **config**: registers all the configurations from an xml file element with the point extension '<appConfig>'
- **parameters**: registers all the configurations from an xml file element with the point extension '<parameters>'

### _helper_

- **config**: provides configuration element parsing tools.
- **config_launcher**: provides few methods to manage config (parsing, starting, stopping...) associated from an xml configuration file element with the point extension '<appConfig>'

### _parser_

- **boolean**: specialisation of GenericField parser for boolean
- **color**: parses an hexa color value from an xml-based description and set it to the color data (`sight::data::color`) object
- **map**: parses and constructs a map (`sight::data::map`) and its associated services from an XML-based description
- **float**: specialisation of GenericField parser for float
- **generic**: parses and constructs a GenericField and its associated services from an XML-based description
- **list**: parses and constructs a List (`sight::data::List`) and its associated services from an XML-based description
- **matrix4**: parses and constructs a square 4x4 Matrix (`sight::data::matrix4`) and its associated services from an XML-based description
- **object**: parses and constructs a generic sight Object (`sight::data::object`) from an XML-based description. Does nothing as no IService method is specialized
- **string**: specialisation of GenericField parser for string
- **transfer_function**: parses and constructs a TransferFunction (`sight::data::transfer_function`) and its associated services from an XML-based description

## How to use it

### CMake

```cmake
target_link_libraries( my_target <PUBLIC|PRIVATE> app)
```