Metadata-Version: 2.1
Name: photoshop_python_api
Version: 0.5.0
Summary: The API for using COM (Component Object Model) objects interfaces of Photoshop.
Home-page: https://github.com/loonghao/photoshop_python_api
Author: Long Hao
Author-email: hal.long@outllok.com
License: UNKNOWN
Description: photoshop_python_api
        ====================
        ![python version](https://img.shields.io/pypi/pyversions/photoshop-python-api)
        [![PyPI version](https://img.shields.io/pypi/v/photoshop-python-api?color=green)](https://badge.fury.io/py/photoshop-python-api)
        [![Documentation Status](https://readthedocs.org/projects/photoshop-python-api/badge/?version=master)](https://photoshop-python-api.readthedocs.io/en/master/?badge=master)
        ![Downloads Status](https://img.shields.io/pypi/dw/photoshop-python-api)
        ![license](https://img.shields.io/pypi/l/photoshop-python-api)
        ![pypi format](https://img.shields.io/pypi/format/photoshop-python-api)
        
        The API for using COM (Component Object Model) objects interfaces of Photoshop.
        
        https://photoshop-python-api.readthedocs.io
        
        ![logo](https://i.imgur.com/9NpsSvd.png)
        
        Has been tested and used Photoshop version:
        
            - 2020
            - cc2019
            - cc2018
            - cc2017
            - cs6
        
        Installing
        ----------
        You can install via pip.
        
        ```cmd
        pip install photoshop_python_api
        ```
        or through clone from Github.
        ```git exclude
        git clone https://github.com/loonghao/photoshop_python_api.git
        ```
        Install package.
        ```cmd
        python setup.py install
        ```
        
        Since it uses COM (Component Object Model) connect Photoshop, it can be used 
        in any DCC software with a python interpreter.
        
        
        Hello World
        -----------
        
        ```python
        
        import photoshop as ps
        app = ps.Application()
        doc = app.documents.add()
        new_doc = doc.artLayers.add()
        text_color = ps.SolidColor()
        text_color.rgb.green = 255
        new_text_layer = new_doc
        new_text_layer.kind = ps.LayerKind.TextLayer
        new_text_layer.textItem.contents = 'Hello, World!'
        new_text_layer.textItem.position = [160, 167]
        new_text_layer.textItem.size = 40
        new_text_layer.textItem.color = text_color
        options = ps.JPEGSaveOptions(quality=5)
        # # save to jpg
        jpg = 'd:/hello_world.jpg'
        doc.saveAs(jpg, options, asCopy=True)
        app.doJavaScript(f'alert("save to jpg: {jpg}")')
        
        ```
        ![demo](https://i.imgur.com/25TrzbV.gif)
        
        
        Photoshop Session
        -----------------
        Use it as context.
        
        ```python
        
        from photoshop import Session
        
        
        with Session() as adobe:
            doc = adobe.app.documents.add()
            text_color = adobe.SolidColor()
            text_color.rgb.green = 255
            new_text_layer = doc.artLayers.add()
            new_text_layer.kind = adobe.LayerKind.TextLayer
            new_text_layer.textItem.contents = 'Hello, World!'
            new_text_layer.textItem.position = [160, 167]
            new_text_layer.textItem.size = 40
            new_text_layer.textItem.color = text_color
            options = adobe.JPEGSaveOptions(quality=5)
            jpg = 'd:/hello_world.jpg'
            doc.saveAs(jpg, options, asCopy=True)
            adobe.app.doJavaScript(f'alert("save to jpg: {jpg}")')
        
        
        ```
        
        More examples
        -------------
        - https://photoshop-python-api.readthedocs.io/en/master/usage.html
        
        
        Useful links
        ----------------------
        - https://theiviaxx.github.io/photoshop-docs/Photoshop/
        - http://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/photoshop/pdfs/photoshop-cc-javascript-ref-2015.pdf
        - https://github.com/lohriialo/photoshop-scripting-python
        - https://www.adobe.com/devnet/photoshop/scripting.html
        - https://www.youtube.com/playlist?list=PLUEniN8BpU8-Qmjyv3zyWaNvDYwJOJZ4m
        - http://yearbook.github.io/esdocs/#/Photoshop/Application
        - http://www.shining-lucy.com/wiki/page.php?id=appwiki:photoshop:ps_script
        - http://www.tonton-pixel.com/wp-content/uploads/DecisionTable.pdf
        - http://jongware.mit.edu/pscs5js_html/psjscs5/pc_Application.html
        - https://indd.adobe.com/view/a0207571-ff5b-4bbf-a540-07079bd21d75
        - http://shining-lucy.com/wiki/page.php?id=appwiki:photoshop:ps_script
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
