Add agent skill documentation section to README.md explaining SKILL.md file purpose, prerequisites coverage, safety rules, script catalog structure, and installation instructions for Devin and Claude Code agents, with repository location notes for both SVN and Git versions
This commit is contained in:
1 parent
c79451b373
commit
95e8d94298
19 files changed
+3413
No files matched your search
@@ -0,0 +1,124 @@
|
||||
# Get-LastFrame.ps1
|
||||
|
||||
Extracts a specific frame of a video file to a PNG image.
|
||||
|
||||
## Parameters
|
||||
|
||||
- **`-Video`** (required): Path to input video file
|
||||
- **`-Image`** (required): Path to output PNG image file. Supports a printf-style numbering token like [Get-FramesRange.ps1](Get-FramesRange.md) — see [Filename Pattern](#filename-pattern). The output directory is created when it does not exist.
|
||||
- **`-Frame`** (optional): 0-based frame index to extract (default: -1)
|
||||
- Positive values: Direct frame index (e.g., 0 = first frame, 100 = frame 100)
|
||||
- Negative values: Count from the end (e.g., -1 = last frame, -2 = second-to-last)
|
||||
- Values are automatically clamped to valid range (0 to total frames - 1)
|
||||
|
||||
## Filename Pattern
|
||||
|
||||
`-Image` may contain a printf-style numbering token, which is replaced with the **actual 0-based frame index that was extracted** — after `-Frame` has been resolved, so negative indices produce the real frame number:
|
||||
|
||||
| Token | Meaning | Frame 99 | Frame 7 |
|
||||
| --- | --- | --- | --- |
|
||||
| `%d` | No padding | `99` | `7` |
|
||||
| `%04d` | Zero-padded to 4 digits | `0099` | `0007` |
|
||||
| `%06d` | Zero-padded to 6 digits | `000099` | `000007` |
|
||||
|
||||
A path without a token is used **literally**, so existing commands such as `-Image last_frame.png` are unaffected (only one frame is produced, so no numbering is needed).
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image "frame_%04d.png"
|
||||
# 100-frame video -> frame_0099.png
|
||||
```
|
||||
|
||||
When the pattern resolves, the script reports the final name:
|
||||
|
||||
```text
|
||||
Total frames: 100 - extracting frame index 99
|
||||
Output pattern resolved to: frame_0099.png
|
||||
Frame saved to: frame_0099.png
|
||||
```
|
||||
|
||||
**Note:** the token is expanded by the script, not by ffmpeg. ffmpeg would treat `%04d` in an output path as an image-sequence counter starting at `1` (writing `frame_0001.png` regardless of which frame was selected); expanding it here guarantees the number is the real video frame index, matching [Get-FramesRange.ps1](Get-FramesRange.md).
|
||||
|
||||
## Examples
|
||||
|
||||
**Extract last frame:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image last_frame.png
|
||||
```
|
||||
|
||||
**Extract specific frame:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image frame_100.png -Frame 100
|
||||
```
|
||||
|
||||
**Extract first frame:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image first_frame.png -Frame 0
|
||||
```
|
||||
|
||||
**Extract second-to-last frame:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image second_last.png -Frame -2
|
||||
```
|
||||
|
||||
**Extract 10th frame from the end:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image frame_minus_10.png -Frame -10
|
||||
```
|
||||
|
||||
**Using absolute paths:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video "C:\Videos\input.mp4" -Image "C:\Frames\output.png" -Frame 50
|
||||
```
|
||||
|
||||
**Filename pattern with the frame number:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image "frame_%04d.png"
|
||||
# If video has 100 frames, creates: frame_0099.png
|
||||
```
|
||||
|
||||
**Full output path with a pattern (directory is created if missing):**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image "C:\Output\frame_%04d.png" -Frame 50
|
||||
# Creates: C:\Output\frame_0050.png
|
||||
```
|
||||
|
||||
**Pattern with a negative frame index:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image "p_%06d.png" -Frame -2
|
||||
# If video has 100 frames, creates: p_000098.png
|
||||
```
|
||||
|
||||
**Pattern without padding:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image "f_%d.png" -Frame 7
|
||||
# Creates: f_7.png
|
||||
```
|
||||
|
||||
## Safe Execution
|
||||
|
||||
This script supports `-WhatIf` and `-Confirm` for safe execution:
|
||||
|
||||
- **`-WhatIf`**: Simulate the operation without actually extracting the frame. Shows the resolved output name and what would be extracted; no output directory is created.
|
||||
- **`-Confirm`**: Prompt for confirmation before extracting the frame.
|
||||
|
||||
**Simulate without extracting:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image frame.png -WhatIf
|
||||
```
|
||||
|
||||
**Prompt before extraction:**
|
||||
|
||||
```powershell
|
||||
.\Get-LastFrame.ps1 -Video video.mp4 -Image frame.png -Frame 100 -Confirm
|
||||
```
|
||||
Reference in new issue
Block a user