tinyblast/README.md

45 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Tinyblast Plugin v2.0.0-beta
Tinyblast is a custom playblast tool for Maya, designed to offer more flexible control over the output format, codec, and playblast settings than the default Maya playblast options.
## New in v2.0.0-beta
- Removed the button from the Playblast Options window.
- Created a new custom window that contains options to choose the file format and codec.
- Added playblast options such as:
- Quality slider
- Resolution scalar
- Frame padding
## Known Limitations
- **Windows Only**: This release is optimized for Mayas `.avi` file output on Windows. Future versions may extend support to other platforms and formats.
- **Uncompressed AVI Temporary File**: Tinyblast relies on Mayas built-in playblast function, which still generates an uncompressed `.avi` file before converting it to the other format. This `.avi` file is temporary and will be deleted by Maya after a few minutes.
## Known Issues
- The `.mov` format currently does not work with the DNxHD, DNxHR, or ProRes codecs.
## Installation
1. Download and install Tinyblast.
2. **Load the Plugin in Maya**:
- Navigate to `Windows > Settings/Preferences > Plug-in Manager`.
- If `Tinyblast.py` is not listed, click **Browse** and locate the `Tinyblast.py` file.
- Check the **Loaded** box to enable the plugin.
- (Optional) Check **Auto-load** to automatically load the plugin every time Maya starts.
3. Access the Playblast Options window in Maya.
## How to Use
Currently, there is no menu button to open Tinyblast. You will need to run the following command in Maya's script editor:
```python
import maya.cmds as cmds
cmds.tinyblastOptions()
```
## Future Plans
- Further improvements to format and codec compatibility.
- Adding more formats and codecs if needed.
- Refining the UI for easier access and use.
## Requirements
- Maya (tested on Maya 2025, but should work with any version that supports the same OpenMaya plugin version).
- FFmpeg bundled with the plugin.