houdini-nodeshape-converter

KO | EN

gitlite — search

#hacktoberfest #react #llm #golang #rust #deep-learning #linux #docker #nodejs #awesome #awesome-list #pytorch #ios #open-source

houdini-nodeshape-converter

(★ 13)

Convert SVG paths to Houdini JSON nodeshapes.

houdini-nodeshape-converter Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Houdini NodeShape Converter

[Node.py]: https://nodepy.org
  [Flask]: http://flask.pocoo.org/

A small [Node.py] + [Flask] application that provides a simple REST-Api to
convert SVG files to Houdini NodeShape JSON files. To allow using the Api
from JavaScript in the browser, it allows cross-origin requests by default.

![](https://i.imgur.com/1znnsnh.png)

> * This form can be found at https://www.niklasrosenstein.com/post/2017-06-13-houdini-nodeshape-converter/
> * An instance of this Api is deployed on Heroku under https://houdini-nodeshape-converter.herokuapp.com/
> * You can find the Heroku deployment in the `heroku` branch

## REST-Api

### GET `/`

__Parameters__

* `?shape_id=`: The ID of the shape to download the JSON file for. The shape
  ID is returned after converting an SVG file with the **POST `/`** API.

### POST `/`

__Parameters__

* `name`: The name of the created shape. This name will be contained in the
  resulting JSON object. If not specified, the file's name is used.
* `xres`: X resolution of the SVG image. If omitted, will be determined from
  the bounding box of all paths that are converted into the Houdini NodeShape.
* `yres`: See `xres`
* `file`: An SVG image file that must contain all elements necessary to
  generate a Houdini NodeShape.

__Returns__

* `status`: `"ok"`
* `name`: The name that was specified via the `name` parameter. If the
  parameter was omitted, the name of the uploaded file will be here.
* `id`: The ID of the shape. Use the **GET `/`** API to download the JSON file.

## Command-line Tool

$ nodepy-pm install git+https://github.com/NiklasRosenstein/houdini-nodeshape-converter.git --global
    $ houdini-nodeshape-converter --help
    Usage: houdini-nodeshape-converter [OPTIONS] SVGFILE [INPUTDIM]

Houdini Nodeshape Converter -- Convert SVG paths to Houdini JSON
      nodeshapes.

With SVGFILE you must specify an SVG file that contains the following
      elements from which a Houdini Nodeshape can be generated:

* <path id="outline"/>
      * <path id="outputs"/>
      * <path id="inputs"/>
      * <path id="flag0"/>
      * <path id="flag1"/>
      * <path id="flag2"/>
      * <path id="flag3"/>
      * <rect id="icon"/>

The INPUTDIM must be of the format `WxH` where W and H specify the width
      and height of the input SVG file. If the parameter is omitted, the
      bounding box of all paths in the SVG file is used instead to normalize the
      shape size to 0..1 range.

Outputs the JSON Nodeshape to stdout.

Options:
      -n, --name TEXT              Name of the shape in the JSON file. Default:
                                  SVGFILE basename
      -s, --cubic-samples INTEGER  Number of samples for cubic curves. Default: 10
      --help                       Show this message and exit.

## Flask Blueprint

To embedd the REST-Api into your existing Flask application:

```python
import flask
import {make_api} from '@NiklasRosenstein/houdini-nodeshape-converter'

app = flask.Flask(__name__)
make_api(app, url_prefix='/houdini-nodeshape-converter/')
```

houdini-nodeshape-converter

houdini-nodeshape-converter Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

houdini-nodeshape-converter

houdini-nodeshape-converter Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README