ponkan-python 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. {py3dscapture → ponkan}/__init__.py +2 -2
  2. {py3dscapture → ponkan}/capture.py +12 -12
  3. {py3dscapture → ponkan}/devices/n3dsxl_ftd3.py +3 -3
  4. {py3dscapture → ponkan}/errors.py +25 -5
  5. {py3dscapture → ponkan}/hardware_gate.py +1 -1
  6. {py3dscapture → ponkan}/image/frame.py +2 -2
  7. {py3dscapture → ponkan}/protocol/layout_3ds.py +3 -3
  8. {py3dscapture → ponkan}/protocol/n3dsxl.py +5 -5
  9. {py3dscapture → ponkan}/streaming/engine.py +8 -8
  10. {py3dscapture → ponkan}/streaming/policies.py +2 -2
  11. {py3dscapture → ponkan}/tools/capture_raw.py +5 -5
  12. {py3dscapture → ponkan}/tools/list_devices.py +2 -2
  13. {py3dscapture → ponkan}/tools/raw_to_png.py +3 -3
  14. {py3dscapture → ponkan}/tools/stream_n3dsxl.py +5 -5
  15. {py3dscapture → ponkan}/transport/d3xx_backend.py +11 -11
  16. {py3dscapture → ponkan}/transport/d3xx_native.py +2 -2
  17. {py3dscapture → ponkan}/transport/d3xx_native_streaming.py +7 -7
  18. {py3dscapture → ponkan}/transport/d3xx_streaming.py +5 -5
  19. {py3dscapture → ponkan}/transport/ftd3_backend.py +4 -4
  20. {py3dscapture → ponkan}/transport/ftd3_pipe.py +3 -3
  21. {py3dscapture → ponkan}/transport/libusb_async.py +1 -1
  22. {py3dscapture → ponkan}/transport/libusb_backend.py +1 -1
  23. {ponkan_python-0.1.0.dist-info → ponkan_python-0.1.2.dist-info}/METADATA +12 -14
  24. ponkan_python-0.1.2.dist-info/RECORD +39 -0
  25. ponkan_python-0.1.2.dist-info/entry_points.txt +5 -0
  26. ponkan_python-0.1.0.dist-info/RECORD +0 -39
  27. ponkan_python-0.1.0.dist-info/entry_points.txt +0 -5
  28. {py3dscapture → ponkan}/artifacts.py +0 -0
  29. {py3dscapture → ponkan}/devices/__init__.py +0 -0
  30. {py3dscapture → ponkan}/image/__init__.py +0 -0
  31. {py3dscapture → ponkan}/protocol/__init__.py +0 -0
  32. {py3dscapture → ponkan}/protocol/sizes.py +0 -0
  33. {py3dscapture → ponkan}/py.typed +0 -0
  34. {py3dscapture → ponkan}/streaming/__init__.py +0 -0
  35. {py3dscapture → ponkan}/streaming/buffers.py +0 -0
  36. {py3dscapture → ponkan}/streaming/stats.py +0 -0
  37. {py3dscapture → ponkan}/tools/__init__.py +0 -0
  38. {py3dscapture → ponkan}/transport/__init__.py +0 -0
  39. {ponkan_python-0.1.0.dist-info → ponkan_python-0.1.2.dist-info}/WHEEL +0 -0
  40. {ponkan_python-0.1.0.dist-info → ponkan_python-0.1.2.dist-info}/licenses/LICENSE +0 -0
  41. {ponkan_python-0.1.0.dist-info → ponkan_python-0.1.2.dist-info}/licenses/NOTICE.md +0 -0
@@ -8,8 +8,8 @@ submodules.
8
8
 
9
9
  from importlib.metadata import PackageNotFoundError, version
10
10
 
11
- from py3dscapture.capture import CaptureConfig, CaptureOutput, CaptureReader, open_capture
12
- from py3dscapture.protocol.sizes import (
11
+ from ponkan.capture import CaptureConfig, CaptureOutput, CaptureReader, open_capture
12
+ from ponkan.protocol.sizes import (
13
13
  ACCEPTED_N3DSXL_PRODUCT_IDS,
14
14
  ACCEPTED_N3DSXL_PRODUCT_STRINGS,
15
15
  N3DSXL_VENDOR_ID,
@@ -8,20 +8,20 @@ from enum import StrEnum
8
8
  from pathlib import Path
9
9
  from typing import TYPE_CHECKING, Literal, Protocol, cast, overload
10
10
 
11
- from py3dscapture.errors import (
11
+ from ponkan.errors import (
12
12
  DecodeError,
13
13
  DeviceNotFound,
14
14
  TransferOverflow,
15
15
  UnsupportedOperation,
16
16
  )
17
- from py3dscapture.image.frame import CaptureFrame, ColorSpace, RGB8Array
18
- from py3dscapture.streaming.policies import DropPolicy
19
- from py3dscapture.streaming.stats import StreamStats
17
+ from ponkan.image.frame import CaptureFrame, ColorSpace, RGB8Array
18
+ from ponkan.streaming.policies import DropPolicy
19
+ from ponkan.streaming.stats import StreamStats
20
20
 
21
21
  if TYPE_CHECKING:
22
- from py3dscapture.protocol.n3dsxl import N3DSXLPipe, N3DSXLSessionIdentity
23
- from py3dscapture.transport.d3xx_streaming import D3xxStreamHandle
24
- from py3dscapture.transport.libusb_async import AsyncTransferBackend
22
+ from ponkan.protocol.n3dsxl import N3DSXLPipe, N3DSXLSessionIdentity
23
+ from ponkan.transport.d3xx_streaming import D3xxStreamHandle
24
+ from ponkan.transport.libusb_async import AsyncTransferBackend
25
25
 
26
26
  CaptureSource = int | str
27
27
  CaptureBackend = Literal["auto", "libusb", "d3xx", "d3xx-native"]
@@ -373,13 +373,13 @@ def _open_d3xx_engine(config: CaptureConfig, *, native: bool) -> CaptureReaderEn
373
373
 
374
374
 
375
375
  def _new_d3xx_backend() -> _D3xxBackend:
376
- from py3dscapture.transport.d3xx_backend import D3xxBackend # noqa: PLC0415
376
+ from ponkan.transport.d3xx_backend import D3xxBackend # noqa: PLC0415
377
377
 
378
378
  return D3xxBackend()
379
379
 
380
380
 
381
381
  def _new_n3dsxl_protocol(handle: _D3xxHandle) -> _N3DSXLConnectProtocol:
382
- from py3dscapture.protocol.n3dsxl import N3DSXLProtocol # noqa: PLC0415
382
+ from ponkan.protocol.n3dsxl import N3DSXLProtocol # noqa: PLC0415
383
383
 
384
384
  return N3DSXLProtocol(
385
385
  cast("N3DSXLSessionIdentity", handle),
@@ -388,13 +388,13 @@ def _new_n3dsxl_protocol(handle: _D3xxHandle) -> _N3DSXLConnectProtocol:
388
388
 
389
389
 
390
390
  def _new_d3xx_backend_async(handle: _D3xxHandle) -> object:
391
- from py3dscapture.transport.d3xx_streaming import D3xxAsyncBackend # noqa: PLC0415
391
+ from ponkan.transport.d3xx_streaming import D3xxAsyncBackend # noqa: PLC0415
392
392
 
393
393
  return D3xxAsyncBackend(cast("D3xxStreamHandle", handle))
394
394
 
395
395
 
396
396
  def _new_d3xx_native_backend(handle: _D3xxHandle, config: CaptureConfig) -> object:
397
- from py3dscapture.transport.d3xx_native_streaming import ( # noqa: PLC0415
397
+ from ponkan.transport.d3xx_native_streaming import ( # noqa: PLC0415
398
398
  D3xxNativeFastPathBackend,
399
399
  )
400
400
 
@@ -402,7 +402,7 @@ def _new_d3xx_native_backend(handle: _D3xxHandle, config: CaptureConfig) -> obje
402
402
 
403
403
 
404
404
  def _new_streaming_engine(async_backend: object, config: CaptureConfig) -> CaptureReaderEngine:
405
- from py3dscapture.streaming.engine import StreamingEngine # noqa: PLC0415
405
+ from ponkan.streaming.engine import StreamingEngine # noqa: PLC0415
406
406
 
407
407
  return StreamingEngine(
408
408
  cast("AsyncTransferBackend", async_backend),
@@ -4,8 +4,8 @@ from contextlib import suppress
4
4
  from dataclasses import dataclass
5
5
  from typing import Literal, cast
6
6
 
7
- from py3dscapture.errors import DeviceOpenError, UnsupportedDevice
8
- from py3dscapture.protocol.sizes import (
7
+ from ponkan.errors import DeviceOpenError, UnsupportedDevice
8
+ from ponkan.protocol.sizes import (
9
9
  ACCEPTED_N3DSXL_PRODUCT_IDS,
10
10
  ACCEPTED_N3DSXL_PRODUCT_STRINGS,
11
11
  N3DSXL_BULK_INTERFACE,
@@ -13,7 +13,7 @@ from py3dscapture.protocol.sizes import (
13
13
  N3DSXL_DEFAULT_CONFIGURATION,
14
14
  N3DSXL_VENDOR_ID,
15
15
  )
16
- from py3dscapture.transport.libusb_backend import LibusbBackend, UsbDeviceInfo, UsbHandle
16
+ from ponkan.transport.libusb_backend import LibusbBackend, UsbDeviceInfo, UsbHandle
17
17
 
18
18
  AcceptedProductString = Literal["N3DSXL", "N3DSXL.2"]
19
19
  ProductStringStatus = Literal["accepted", "unreadable"]
@@ -4,7 +4,7 @@ from dataclasses import dataclass
4
4
 
5
5
 
6
6
  class CaptureError(Exception):
7
- """Base exception for py3dscapture failures.
7
+ """Base exception for ponkan failures.
8
8
 
9
9
  Catch this when callers want to handle package-level failures without
10
10
  matching individual USB, decode, or optional-dependency errors.
@@ -103,11 +103,31 @@ class DecodeError(CaptureError):
103
103
  """
104
104
 
105
105
 
106
- class OptionalDependencyError(CaptureError):
107
- """Raised when an optional adapter dependency is missing.
106
+ class DependencyUnavailableError(CaptureError):
107
+ """Raised when a runtime dependency required by a selected path is missing.
108
108
 
109
- Optional extras currently include image conversion dependencies and the D3XX
110
- backend dependency.
109
+ This covers platform-gated normal dependencies as well as more specific
110
+ optional-extra dependencies.
111
+ """
112
+
113
+ @classmethod
114
+ def for_backend_dependency(
115
+ cls,
116
+ dependency: str,
117
+ backend: str,
118
+ ) -> "DependencyUnavailableError":
119
+ """Create an error for a dependency required by one backend."""
120
+ return cls(
121
+ f"{dependency} is required for the {backend} backend. "
122
+ "Install ponkan-python with dependencies for this platform, or select a "
123
+ "backend supported by this environment."
124
+ )
125
+
126
+
127
+ class OptionalDependencyError(DependencyUnavailableError):
128
+ """Raised when a dependency provided by an optional extra is missing.
129
+
130
+ Optional extras currently include image conversion dependencies.
111
131
  """
112
132
 
113
133
  def __init__(self, dependency: str, extra: str) -> None:
@@ -5,7 +5,7 @@ from collections.abc import Mapping
5
5
  from dataclasses import dataclass
6
6
  from typing import Literal
7
7
 
8
- from py3dscapture.protocol.sizes import (
8
+ from ponkan.protocol.sizes import (
9
9
  ACCEPTED_N3DSXL_PRODUCT_IDS,
10
10
  ACCEPTED_N3DSXL_PRODUCT_STRINGS,
11
11
  N3DSXL_VENDOR_ID,
@@ -7,8 +7,8 @@ from typing import TYPE_CHECKING, Literal, Protocol, cast
7
7
  import numpy as np
8
8
  from numpy.typing import NDArray
9
9
 
10
- from py3dscapture.errors import DecodeError, OptionalDependencyError
11
- from py3dscapture.protocol.sizes import BOTTOM_WIDTH_3DS, HEIGHT_3DS, TOP_WIDTH_3DS
10
+ from ponkan.errors import DecodeError, OptionalDependencyError
11
+ from ponkan.protocol.sizes import BOTTOM_WIDTH_3DS, HEIGHT_3DS, TOP_WIDTH_3DS
12
12
 
13
13
  ColorSpace = Literal["RGB", "BGR"]
14
14
  ScreenName = Literal["top", "bottom", "top_right"]
@@ -2,9 +2,9 @@
2
2
 
3
3
  import numpy as np
4
4
 
5
- from py3dscapture.errors import DecodeError
6
- from py3dscapture.image.frame import CaptureFrame
7
- from py3dscapture.protocol.sizes import (
5
+ from ponkan.errors import DecodeError
6
+ from ponkan.image.frame import CaptureFrame
7
+ from ponkan.protocol.sizes import (
8
8
  BOTTOM_WIDTH_3DS,
9
9
  HEIGHT_3DS,
10
10
  TOP_WIDTH_3DS,
@@ -3,16 +3,16 @@
3
3
  from time import sleep
4
4
  from typing import Protocol
5
5
 
6
- from py3dscapture.capture import RawCapture
7
- from py3dscapture.devices.n3dsxl_ftd3 import DeviceCandidate
8
- from py3dscapture.errors import UnsupportedDevice, UnsupportedOperation
9
- from py3dscapture.protocol.sizes import (
6
+ from ponkan.capture import RawCapture
7
+ from ponkan.devices.n3dsxl_ftd3 import DeviceCandidate
8
+ from ponkan.errors import UnsupportedDevice, UnsupportedOperation
9
+ from ponkan.protocol.sizes import (
10
10
  N3DSXL_BULK_IN_ENDPOINT,
11
11
  N3DSXL_BULK_OUT_ENDPOINT,
12
12
  capture_size,
13
13
  video_size,
14
14
  )
15
- from py3dscapture.transport.ftd3_pipe import FTD3_COMMAND_TIMEOUT_MS
15
+ from ponkan.transport.ftd3_pipe import FTD3_COMMAND_TIMEOUT_MS
16
16
 
17
17
  N3DSXL_CFG_WAIT_MS = 200
18
18
  N3DSXL_RAW_FRAME_READ_ATTEMPTS = 8
@@ -5,14 +5,14 @@ import queue
5
5
  import time
6
6
  from collections.abc import AsyncIterator, Callable, Iterator
7
7
 
8
- from py3dscapture.errors import DecodeError
9
- from py3dscapture.image.frame import CaptureFrame
10
- from py3dscapture.protocol.layout_3ds import decode_rgb8_2d
11
- from py3dscapture.protocol.sizes import capture_size, video_size
12
- from py3dscapture.streaming.buffers import BufferPool, RawFrameResult, RawFrameSlot
13
- from py3dscapture.streaming.policies import BoundedFrameQueue, DropPolicy, put_frame_with_policy
14
- from py3dscapture.streaming.stats import StreamStats, StreamTimingCollector, TimingSummary
15
- from py3dscapture.transport.libusb_async import AsyncTransferBackend
8
+ from ponkan.errors import DecodeError
9
+ from ponkan.image.frame import CaptureFrame
10
+ from ponkan.protocol.layout_3ds import decode_rgb8_2d
11
+ from ponkan.protocol.sizes import capture_size, video_size
12
+ from ponkan.streaming.buffers import BufferPool, RawFrameResult, RawFrameSlot
13
+ from ponkan.streaming.policies import BoundedFrameQueue, DropPolicy, put_frame_with_policy
14
+ from ponkan.streaming.stats import StreamStats, StreamTimingCollector, TimingSummary
15
+ from ponkan.transport.libusb_async import AsyncTransferBackend
16
16
 
17
17
  Decoder = Callable[[bytes], CaptureFrame]
18
18
 
@@ -4,8 +4,8 @@ from collections import deque
4
4
  from collections.abc import Iterator
5
5
  from typing import Literal
6
6
 
7
- from py3dscapture.image.frame import CaptureFrame
8
- from py3dscapture.streaming.stats import StreamStats
7
+ from ponkan.image.frame import CaptureFrame
8
+ from ponkan.streaming.stats import StreamStats
9
9
 
10
10
  DropPolicy = Literal["drop_oldest", "drop_newest", "block"]
11
11
  CopyPolicy = Literal["copy_decoded_frame_before_release_raw_slot", "zero_copy_experimental"]
@@ -3,11 +3,11 @@
3
3
  import argparse
4
4
  from pathlib import Path
5
5
 
6
- from py3dscapture.capture import save_raw_capture
7
- from py3dscapture.devices.n3dsxl_ftd3 import N3DSXLDevice, list_n3dsxl_devices
8
- from py3dscapture.protocol.n3dsxl import N3DSXLProtocol
9
- from py3dscapture.transport.ftd3_pipe import Ftd3Pipe
10
- from py3dscapture.transport.libusb_backend import Usb1Backend
6
+ from ponkan.capture import save_raw_capture
7
+ from ponkan.devices.n3dsxl_ftd3 import N3DSXLDevice, list_n3dsxl_devices
8
+ from ponkan.protocol.n3dsxl import N3DSXLProtocol
9
+ from ponkan.transport.ftd3_pipe import Ftd3Pipe
10
+ from ponkan.transport.libusb_backend import Usb1Backend
11
11
 
12
12
 
13
13
  def main(argv: list[str] | None = None) -> int:
@@ -1,7 +1,7 @@
1
1
  """List N3DSXL USB device candidates."""
2
2
 
3
- from py3dscapture.devices.n3dsxl_ftd3 import DeviceListing, list_n3dsxl_devices
4
- from py3dscapture.transport.libusb_backend import LibusbBackend, Usb1Backend
3
+ from ponkan.devices.n3dsxl_ftd3 import DeviceListing, list_n3dsxl_devices
4
+ from ponkan.transport.libusb_backend import LibusbBackend, Usb1Backend
5
5
 
6
6
 
7
7
  def format_device_listing(listing: DeviceListing) -> str:
@@ -9,9 +9,9 @@ from typing import Literal
9
9
 
10
10
  import numpy as np
11
11
 
12
- from py3dscapture.image.frame import CaptureFrame
13
- from py3dscapture.protocol.layout_3ds import APPROVED_N3DSXL_2D_DECODER_ID, decode_rgb8_2d
14
- from py3dscapture.protocol.sizes import BOTTOM_WIDTH_3DS, HEIGHT_3DS, TOP_WIDTH_3DS
12
+ from ponkan.image.frame import CaptureFrame
13
+ from ponkan.protocol.layout_3ds import APPROVED_N3DSXL_2D_DECODER_ID, decode_rgb8_2d
14
+ from ponkan.protocol.sizes import BOTTOM_WIDTH_3DS, HEIGHT_3DS, TOP_WIDTH_3DS
15
15
 
16
16
  ProbeCandidateId = Literal[
17
17
  "legacy_top_first_transpose",
@@ -6,13 +6,13 @@ import time
6
6
  from pathlib import Path
7
7
  from typing import TYPE_CHECKING, Literal, cast
8
8
 
9
- from py3dscapture.artifacts import write_json_artifact
10
- from py3dscapture.streaming.engine import StreamingEngine
11
- from py3dscapture.streaming.stats import PerformanceStats, StreamingBackendKind
12
- from py3dscapture.transport.libusb_async import LibusbAsyncBackend
9
+ from ponkan.artifacts import write_json_artifact
10
+ from ponkan.streaming.engine import StreamingEngine
11
+ from ponkan.streaming.stats import PerformanceStats, StreamingBackendKind
12
+ from ponkan.transport.libusb_async import LibusbAsyncBackend
13
13
 
14
14
  if TYPE_CHECKING:
15
- from py3dscapture.streaming.policies import DropPolicy
15
+ from ponkan.streaming.policies import DropPolicy
16
16
 
17
17
 
18
18
  def run_streaming_smoke(
@@ -9,10 +9,10 @@ from importlib import import_module
9
9
  from types import ModuleType
10
10
  from typing import Any, Literal, Protocol, cast
11
11
 
12
- from py3dscapture.devices.n3dsxl_ftd3 import DeviceCandidate, classify_n3dsxl_device
13
- from py3dscapture.errors import CaptureError, OptionalDependencyError
14
- from py3dscapture.protocol.sizes import N3DSXL_VENDOR_ID
15
- from py3dscapture.transport.libusb_backend import UsbDeviceInfo
12
+ from ponkan.devices.n3dsxl_ftd3 import DeviceCandidate, classify_n3dsxl_device
13
+ from ponkan.errors import CaptureError, DependencyUnavailableError
14
+ from ponkan.protocol.sizes import N3DSXL_VENDOR_ID
15
+ from ponkan.transport.libusb_backend import UsbDeviceInfo
16
16
 
17
17
  FT_OK = 0
18
18
  D3XX_OPEN_BY_SERIAL_NUMBER = 0x01
@@ -481,13 +481,13 @@ class D3xxHandle:
481
481
 
482
482
 
483
483
  def load_pyd3xx_binding() -> D3xxBinding:
484
- """Import the optional PyD3XX module.
484
+ """Import the PyD3XX module used by the Windows D3XX backend.
485
485
 
486
486
  Returns:
487
487
  Imported module cast to the D3XX binding protocol.
488
488
 
489
489
  Raises:
490
- OptionalDependencyError: Neither supported PyD3XX module name can be
490
+ DependencyUnavailableError: Neither supported PyD3XX module name can be
491
491
  imported.
492
492
  """
493
493
  for module_name in PYD3XX_MODULE_NAMES:
@@ -495,7 +495,7 @@ def load_pyd3xx_binding() -> D3xxBinding:
495
495
  return cast("D3xxBinding", import_module(module_name))
496
496
  except ImportError:
497
497
  continue
498
- raise OptionalDependencyError("PyD3XX", "d3xx")
498
+ raise DependencyUnavailableError.for_backend_dependency("PyD3XX", "Windows D3XX")
499
499
 
500
500
 
501
501
  class D3xxBackend:
@@ -506,15 +506,15 @@ class D3xxBackend:
506
506
  """
507
507
 
508
508
  def __init__(self, binding: D3xxBinding | None = None) -> None:
509
- """Create a backend using an injected or optional PyD3XX binding.
509
+ """Create a backend using an injected or installed PyD3XX binding.
510
510
 
511
511
  Args:
512
512
  binding: Optional test or real PyD3XX binding. When omitted, the
513
- optional dependency is imported lazily.
513
+ installed dependency is imported lazily.
514
514
 
515
515
  Raises:
516
- OptionalDependencyError: ``binding`` is omitted and PyD3XX is not
517
- installed.
516
+ DependencyUnavailableError: ``binding`` is omitted and PyD3XX is not
517
+ installed or not supported in the current environment.
518
518
  """
519
519
  self._binding = binding or load_pyd3xx_binding()
520
520
 
@@ -4,8 +4,8 @@ import ctypes
4
4
  from dataclasses import dataclass
5
5
  from typing import ClassVar, Protocol, cast
6
6
 
7
- from py3dscapture.errors import CaptureError
8
- from py3dscapture.transport.d3xx_backend import D3xxBackendError
7
+ from ponkan.errors import CaptureError
8
+ from ponkan.transport.d3xx_backend import D3xxBackendError
9
9
 
10
10
  FT_OK = 0
11
11
  FT_TIMEOUT = 19
@@ -8,10 +8,10 @@ from dataclasses import dataclass
8
8
  from threading import Event, Lock, Thread
9
9
  from typing import TYPE_CHECKING, Protocol, cast
10
10
 
11
- from py3dscapture.protocol.sizes import N3DSXL_BULK_IN_ENDPOINT, capture_size
12
- from py3dscapture.streaming.buffers import RawFrameSlot
13
- from py3dscapture.transport.d3xx_backend import D3XX_DEFAULT_TIMEOUT_MS, D3xxBackendError
14
- from py3dscapture.transport.d3xx_native import (
11
+ from ponkan.protocol.sizes import N3DSXL_BULK_IN_ENDPOINT, capture_size
12
+ from ponkan.streaming.buffers import RawFrameSlot
13
+ from ponkan.transport.d3xx_backend import D3XX_DEFAULT_TIMEOUT_MS, D3xxBackendError
14
+ from ponkan.transport.d3xx_native import (
15
15
  FT_IO_INCOMPLETE,
16
16
  FT_IO_PENDING,
17
17
  FT_OK,
@@ -19,10 +19,10 @@ from py3dscapture.transport.d3xx_native import (
19
19
  NativeOverlapped,
20
20
  NativeTransferResult,
21
21
  )
22
- from py3dscapture.transport.libusb_async import AsyncTransferCallback
22
+ from ponkan.transport.libusb_async import AsyncTransferCallback
23
23
 
24
24
  if TYPE_CHECKING:
25
- from py3dscapture.transport.d3xx_native import D3xxNativeHandleProvider
25
+ from ponkan.transport.d3xx_native import D3xxNativeHandleProvider
26
26
 
27
27
  NativeBufferFactory = Callable[[int], ctypes.Array[ctypes.c_char]]
28
28
 
@@ -167,7 +167,7 @@ class D3xxNativeFastPathBackend:
167
167
  self._native_api.set_stream_pipe(self._pipe, self._read_size)
168
168
  self._pump = Thread(
169
169
  target=self._completion_pump,
170
- name="py3dscapture-d3xx-native-stream",
170
+ name="ponkan-d3xx-native-stream",
171
171
  )
172
172
  self._pump.start()
173
173
 
@@ -5,10 +5,10 @@ from concurrent.futures import Future, ThreadPoolExecutor, wait
5
5
  from threading import Event, Lock
6
6
  from typing import Protocol
7
7
 
8
- from py3dscapture.protocol.sizes import N3DSXL_BULK_IN_ENDPOINT
9
- from py3dscapture.streaming.buffers import RawFrameSlot
10
- from py3dscapture.transport.d3xx_backend import D3XX_DEFAULT_TIMEOUT_MS, D3xxBackendError
11
- from py3dscapture.transport.libusb_async import AsyncTransferCallback
8
+ from ponkan.protocol.sizes import N3DSXL_BULK_IN_ENDPOINT
9
+ from ponkan.streaming.buffers import RawFrameSlot
10
+ from ponkan.transport.d3xx_backend import D3XX_DEFAULT_TIMEOUT_MS, D3xxBackendError
11
+ from ponkan.transport.libusb_async import AsyncTransferCallback
12
12
 
13
13
 
14
14
  class D3xxAsyncBackendConfigError(ValueError):
@@ -95,7 +95,7 @@ class D3xxAsyncBackend:
95
95
  self._timeout_ms = timeout_ms
96
96
  self._executor = ThreadPoolExecutor(
97
97
  max_workers=max_workers,
98
- thread_name_prefix="py3dscapture-d3xx-stream",
98
+ thread_name_prefix="ponkan-d3xx-stream",
99
99
  )
100
100
  self._cancel_requested = Event()
101
101
  self._lock = Lock()
@@ -2,10 +2,10 @@
2
2
 
3
3
  from typing import Literal, Protocol, cast
4
4
 
5
- from py3dscapture.devices.n3dsxl_ftd3 import DeviceCandidate, N3DSXLDevice
6
- from py3dscapture.errors import DeviceOpenError
7
- from py3dscapture.transport.ftd3_pipe import FTD3_COMMAND_TIMEOUT_MS, Ftd3Pipe
8
- from py3dscapture.transport.libusb_backend import LibusbBackend
5
+ from ponkan.devices.n3dsxl_ftd3 import DeviceCandidate, N3DSXLDevice
6
+ from ponkan.errors import DeviceOpenError
7
+ from ponkan.transport.ftd3_pipe import FTD3_COMMAND_TIMEOUT_MS, Ftd3Pipe
8
+ from ponkan.transport.libusb_backend import LibusbBackend
9
9
 
10
10
  BackendKind = Literal["libusb", "d3xx"]
11
11
 
@@ -3,9 +3,9 @@
3
3
  from struct import pack
4
4
  from typing import Final
5
5
 
6
- from py3dscapture.devices.n3dsxl_ftd3 import N3DSXLDevice
7
- from py3dscapture.errors import Ftd3CommandContext, Ftd3CommandError, UnsupportedDevice
8
- from py3dscapture.protocol.sizes import N3DSXL_FTD3_COMMAND_PIPE_ID
6
+ from ponkan.devices.n3dsxl_ftd3 import N3DSXLDevice
7
+ from ponkan.errors import Ftd3CommandContext, Ftd3CommandError, UnsupportedDevice
8
+ from ponkan.protocol.sizes import N3DSXL_FTD3_COMMAND_PIPE_ID
9
9
 
10
10
  FTD3_COMMAND_CREATE_PIPE_ID: Final = 0x82
11
11
  FTD3_COMMAND_TIMEOUT_MS: Final = 500
@@ -2,7 +2,7 @@
2
2
 
3
3
  from typing import Protocol
4
4
 
5
- from py3dscapture.streaming.buffers import RawFrameSlot
5
+ from ponkan.streaming.buffers import RawFrameSlot
6
6
 
7
7
 
8
8
  class AsyncTransferCallback(Protocol):
@@ -6,7 +6,7 @@ from dataclasses import dataclass
6
6
  from importlib import import_module
7
7
  from typing import TYPE_CHECKING, Protocol, cast
8
8
 
9
- from py3dscapture.errors import DeviceOpenError
9
+ from ponkan.errors import DeviceOpenError
10
10
 
11
11
  if TYPE_CHECKING:
12
12
  from collections.abc import Callable
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ponkan-python
3
- Version: 0.1.0
3
+ Version: 0.1.2
4
4
  Summary: A Python capture library focused on new 3DS XL capture board frame acquisition.
5
5
  Project-URL: Documentation, https://github.com/niart120/ponkan-python/blob/master/docs/api.md
6
6
  Project-URL: Homepage, https://github.com/niart120/ponkan-python
@@ -21,11 +21,10 @@ Classifier: Programming Language :: Python :: 3.12
21
21
  Classifier: Programming Language :: Python :: 3.13
22
22
  Classifier: Topic :: Multimedia :: Video :: Capture
23
23
  Classifier: Typing :: Typed
24
- Requires-Python: <3.14,>=3.12
24
+ Requires-Python: >=3.12
25
25
  Requires-Dist: libusb1>=3.3.1
26
26
  Requires-Dist: numpy>=2.0
27
- Provides-Extra: d3xx
28
- Requires-Dist: pyd3xx>=1.1.4; extra == 'd3xx'
27
+ Requires-Dist: pyd3xx>=1.1.4; sys_platform == 'win32'
29
28
  Provides-Extra: image
30
29
  Requires-Dist: pillow>=10.0; extra == 'image'
31
30
  Provides-Extra: opencv
@@ -54,17 +53,16 @@ Description-Content-Type: text/markdown
54
53
 
55
54
  ## Installation
56
55
 
57
- Python 3.12 / 3.13 を対象にしています。
56
+ Python 3.12 以上を対象にしています。現在の検証基準は Python 3.12 / 3.13 です。
58
57
 
59
58
  ```console
60
59
  pip install ponkan-python
61
60
  ```
62
61
 
63
- PNG 変換には Pillow extra、FTDI D3XX backend には D3XX extra を追加します。
62
+ Windows の FTDI D3XX backend では、通常依存として PyD3XX を利用します。PNG 変換には Pillow extra を追加します。
64
63
 
65
64
  ```console
66
65
  pip install "ponkan-python[image]"
67
- pip install "ponkan-python[d3xx]"
68
66
  ```
69
67
 
70
68
  ## Usage
@@ -72,7 +70,7 @@ pip install "ponkan-python[d3xx]"
72
70
  高レベル API では、new 3DS XL capture board を開いて `read()` で RGB8 `numpy.ndarray` を取得できます。
73
71
 
74
72
  ```python
75
- from py3dscapture import CaptureOutput, open_capture
73
+ from ponkan import CaptureOutput, open_capture
76
74
 
77
75
  with open_capture(output=CaptureOutput.BOTH_VERTICAL) as cap:
78
76
  image = cap.read()
@@ -83,7 +81,7 @@ with open_capture(output=CaptureOutput.BOTH_VERTICAL) as cap:
83
81
  上画面だけを読む場合は `CaptureOutput.TOP` を指定します。OpenCV へ渡す場合は `colorspace="BGR"` を指定できます。
84
82
 
85
83
  ```python
86
- from py3dscapture import CaptureOutput, open_capture
84
+ from ponkan import CaptureOutput, open_capture
87
85
 
88
86
  with open_capture(output=CaptureOutput.TOP, colorspace="BGR") as cap:
89
87
  top_bgr = cap.read()
@@ -92,7 +90,7 @@ with open_capture(output=CaptureOutput.TOP, colorspace="BGR") as cap:
92
90
  3DS 固有の上画面・下画面・sequence などが必要な場合は `read_frame()` を使います。
93
91
 
94
92
  ```python
95
- from py3dscapture import open_capture
93
+ from ponkan import open_capture
96
94
 
97
95
  with open_capture() as cap:
98
96
  frame = cap.read_frame()
@@ -108,10 +106,10 @@ API の詳細は [API Reference](https://github.com/niart120/ponkan-python/blob/
108
106
  インストール後は次の console scripts を利用できます。
109
107
 
110
108
  ```console
111
- py3dscapture-list-devices
112
- py3dscapture-capture-raw --out captures/n3dsxl/raw_2d_001.bin
113
- py3dscapture-raw-to-png captures/n3dsxl/raw_2d_001.bin --metadata captures/n3dsxl/raw_2d_001.json --out captures/n3dsxl/png
114
- py3dscapture-stream-n3dsxl --duration 10 --stats
109
+ ponkan-list-devices
110
+ ponkan-capture-raw --out captures/n3dsxl/raw_2d_001.bin
111
+ ponkan-raw-to-png captures/n3dsxl/raw_2d_001.bin --metadata captures/n3dsxl/raw_2d_001.json --out captures/n3dsxl/png
112
+ ponkan-stream-n3dsxl --duration 10 --stats
115
113
  ```
116
114
 
117
115
  実機へ N3DSXL command を送る操作は、事前に device identity と安全境界を確認してから実行してください。
@@ -0,0 +1,39 @@
1
+ ponkan/__init__.py,sha256=_vkWfGQYiqZMwCBR_lhCoZ4A2MK6LHWL9F7WkU87xRw,985
2
+ ponkan/artifacts.py,sha256=E5C63HfEnkQBeXH0E-oQ1_NhhzJYcYYNUrw5S-OtUL8,1961
3
+ ponkan/capture.py,sha256=VU7UNVadGZDkzpyS-agdPFwCpU2e6IUAAneZeLtRKZs,20190
4
+ ponkan/errors.py,sha256=TpPgmmL9OsVOlPtl3iyVLS6oouaRXbePKdXt8npMjBA,4385
5
+ ponkan/hardware_gate.py,sha256=1f6WP2rDTNTo35IRLjeK8S7cJeVUDFZ5aVoJ88oo8Qw,4828
6
+ ponkan/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
7
+ ponkan/devices/__init__.py,sha256=uYvgYIgcwciikPR23c_p674XuJDKTamUH0PKV3ECXiE,30
8
+ ponkan/devices/n3dsxl_ftd3.py,sha256=KbIqZLaI-J_QzPJSIhSQndE6flurcbQbm0reNbLW9F8,8387
9
+ ponkan/image/__init__.py,sha256=-23f78dfqU2Q-WOIvYCqstSexYId_K3sP8pBn7tkUQU,38
10
+ ponkan/image/frame.py,sha256=_3FbgVXivKD94rmYq_oODyyk2Nh7_7nau7bhIzYFvjE,5788
11
+ ponkan/protocol/__init__.py,sha256=lCr27_-ula3CtVd5nzTFbhEARAoiMecGEv8n8Q_xH6I,48
12
+ ponkan/protocol/layout_3ds.py,sha256=30UcCFzYmfegPyTkAwwd52HB_aR1SG2v769Obo8sKtg,1950
13
+ ponkan/protocol/n3dsxl.py,sha256=HOla_sLiNZWBWqOX29G8x0KlyzXx4RnJIIVnBTgfpRU,8424
14
+ ponkan/protocol/sizes.py,sha256=AlI9Ge-Dk6Rx8UI4eF2VVRpxcZ_pCEuC46TVc-qmJxQ,4129
15
+ ponkan/streaming/__init__.py,sha256=30b10h-HyMhyGW0emIJ1Cc_189kolDxuNoYMfft05Hc,35
16
+ ponkan/streaming/buffers.py,sha256=03ku6ZWkWwo4b6q9gnYaJmoee7zqur9WEkEUyHe6tI8,4727
17
+ ponkan/streaming/engine.py,sha256=oI-iyGDFUA9-YC3YX5QOnuS4z_i8g211PSXXv5NMFYs,10743
18
+ ponkan/streaming/policies.py,sha256=VUPdpJTDL4I2mgJC5qmrYOHQEGCSI8FjEjsjjOryM_g,4308
19
+ ponkan/streaming/stats.py,sha256=WT7q16CPtOel95xGn3uG6iXSzA15WOEMjlSWJ3hbzWY,8534
20
+ ponkan/tools/__init__.py,sha256=tMgzvLN5Tq0ia16r9UUMA6QOZ8NOHjwJRuS0KSk9LAg,28
21
+ ponkan/tools/capture_raw.py,sha256=SSGbvTxs_uirJ_UeIy9uIXVBem1pRTrs2DpHVezPxs8,1478
22
+ ponkan/tools/list_devices.py,sha256=BpqtH0o0PcjibGRClEM4GDfyGHI0MLq2BZ4n-FAINLo,2313
23
+ ponkan/tools/raw_to_png.py,sha256=4MvD2J7IqKmHWabBAD1JSvDPdkxvSUS6pPXJLaq2sqM,8008
24
+ ponkan/tools/stream_n3dsxl.py,sha256=YzEVwgq_ul5H7N617JICyaTlFqK_yAxfH60T2ieEPbE,5317
25
+ ponkan/transport/__init__.py,sha256=zp3na4DRpaD2_RCvB5rGxdZW7xOahfhmJpdvvpPpBFI,29
26
+ ponkan/transport/d3xx_backend.py,sha256=U8bIPv2U0ZRNHYHADuroUVVdijCqVQDOnHA_HLkYXuw,27035
27
+ ponkan/transport/d3xx_native.py,sha256=-yBKecFENaYimGIgK2UoNgjoW8q6od4aMWGyMtdX5xM,9007
28
+ ponkan/transport/d3xx_native_streaming.py,sha256=4aa8FFbZxJJM9IrudWcDU_P7mOIr238VtWhRpJqRi50,10872
29
+ ponkan/transport/d3xx_streaming.py,sha256=cWC1cqcFejZavbBe-N8GisVm00H4UhMh0yW68ylWVWc,6669
30
+ ponkan/transport/ftd3_backend.py,sha256=wwQIQnW3Tkh02QkwPbeHzVtqiIK3zVGGMn1xpIc-SoE,7771
31
+ ponkan/transport/ftd3_pipe.py,sha256=QntLlKLwwW6sxNq_BgHHhyyFxOJxhnTB1Ux2CCS9_vQ,12661
32
+ ponkan/transport/libusb_async.py,sha256=mghsycUK0XvnDYqQRDhu_brzDvj_ECEc0txN2RuBpSw,4129
33
+ ponkan/transport/libusb_backend.py,sha256=-FkZkEDHmBA0FLU3TwGKG1iVcH5dlu3Mu9sONuhpCak,11031
34
+ ponkan_python-0.1.2.dist-info/METADATA,sha256=I-M9h72pFNsNZXOGORBRvRgh5yYzN7htbfWXbuXfEaA,5754
35
+ ponkan_python-0.1.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
36
+ ponkan_python-0.1.2.dist-info/entry_points.txt,sha256=6C8SCtqa7D-Rvf4EIfXrdlxJ4pQHhjLiAwlS4OS5d4w,226
37
+ ponkan_python-0.1.2.dist-info/licenses/LICENSE,sha256=ikr_NtR46ZO2hvTX0LtCeb9wbRb19pCcY97Hw_6VA6c,1096
38
+ ponkan_python-0.1.2.dist-info/licenses/NOTICE.md,sha256=KZPWtflkTM1GTH5e5UP7OvP7D8xYJotWUxgiePabylc,445
39
+ ponkan_python-0.1.2.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ [console_scripts]
2
+ ponkan-capture-raw = ponkan.tools.capture_raw:main
3
+ ponkan-list-devices = ponkan.tools.list_devices:main
4
+ ponkan-raw-to-png = ponkan.tools.raw_to_png:main
5
+ ponkan-stream-n3dsxl = ponkan.tools.stream_n3dsxl:main
@@ -1,39 +0,0 @@
1
- py3dscapture/__init__.py,sha256=1BdGPUhO7y--e5L2hqSnxhiHaRua_5aZ872T6vkEWz0,997
2
- py3dscapture/artifacts.py,sha256=E5C63HfEnkQBeXH0E-oQ1_NhhzJYcYYNUrw5S-OtUL8,1961
3
- py3dscapture/capture.py,sha256=L7wfW25safua22VRjDXfvjNduzwOW-jNP7j73LLzxNM,20262
4
- py3dscapture/errors.py,sha256=S-f6yGSYaQH1y8X2loeRSiANwiDOzCRdnMt6441EQC0,3695
5
- py3dscapture/hardware_gate.py,sha256=FClF7ckNH9kTXy833YgwDuKuGBkoAGFkDkf5IlBDsms,4834
6
- py3dscapture/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
7
- py3dscapture/devices/__init__.py,sha256=uYvgYIgcwciikPR23c_p674XuJDKTamUH0PKV3ECXiE,30
8
- py3dscapture/devices/n3dsxl_ftd3.py,sha256=md6WyM9W1n-VY5L7uEhZbjWdTO044-oR4onkacJpwrM,8405
9
- py3dscapture/image/__init__.py,sha256=-23f78dfqU2Q-WOIvYCqstSexYId_K3sP8pBn7tkUQU,38
10
- py3dscapture/image/frame.py,sha256=yQ4gtMgFXv9DR72kgezi3oOKvaVYfXrNFCgpTc4h8Ok,5800
11
- py3dscapture/protocol/__init__.py,sha256=lCr27_-ula3CtVd5nzTFbhEARAoiMecGEv8n8Q_xH6I,48
12
- py3dscapture/protocol/layout_3ds.py,sha256=sqRbBqHe_VSkPp8zso5iVVk8Yc-sEH9CZLyD05ZiBXA,1968
13
- py3dscapture/protocol/n3dsxl.py,sha256=_fpiWGoHle7qgtMk59o1YdM_HDldHxQZE2mgN_4F-b0,8454
14
- py3dscapture/protocol/sizes.py,sha256=AlI9Ge-Dk6Rx8UI4eF2VVRpxcZ_pCEuC46TVc-qmJxQ,4129
15
- py3dscapture/streaming/__init__.py,sha256=30b10h-HyMhyGW0emIJ1Cc_189kolDxuNoYMfft05Hc,35
16
- py3dscapture/streaming/buffers.py,sha256=03ku6ZWkWwo4b6q9gnYaJmoee7zqur9WEkEUyHe6tI8,4727
17
- py3dscapture/streaming/engine.py,sha256=wvuiF074n546FuzsQeYi9EYutcYPmNSjzrLoYE_-Yzg,10791
18
- py3dscapture/streaming/policies.py,sha256=lXsNQJROi7IYZPJkLNvJn1xG8dqfE5-OiKb0RqFjiJE,4320
19
- py3dscapture/streaming/stats.py,sha256=WT7q16CPtOel95xGn3uG6iXSzA15WOEMjlSWJ3hbzWY,8534
20
- py3dscapture/tools/__init__.py,sha256=tMgzvLN5Tq0ia16r9UUMA6QOZ8NOHjwJRuS0KSk9LAg,28
21
- py3dscapture/tools/capture_raw.py,sha256=mDL68bfAGD3nFI4rmAkvJ7QolE7X6ay3MN5u6XmaYuk,1508
22
- py3dscapture/tools/list_devices.py,sha256=kVD1mHHcU0qtWf9pIwakP_j80b_Ar2tMofksioGEfMA,2325
23
- py3dscapture/tools/raw_to_png.py,sha256=qnP-To6p4tg7-y4vDke07Oy0zPzv9Yk12fVHhuux-_I,8026
24
- py3dscapture/tools/stream_n3dsxl.py,sha256=8A9vsiB5nsdLdSsuvmrXw6XPpIzgEex94-tmN5QHe2o,5347
25
- py3dscapture/transport/__init__.py,sha256=zp3na4DRpaD2_RCvB5rGxdZW7xOahfhmJpdvvpPpBFI,29
26
- py3dscapture/transport/d3xx_backend.py,sha256=EBg0dtaHxGak929h1JJuFxrOajr-ZgzCo_89qZQtqVs,26946
27
- py3dscapture/transport/d3xx_native.py,sha256=3Njbl0GwEy_YXrfhAa3y67GZ3OdF87lL3twQNYueUYw,9019
28
- py3dscapture/transport/d3xx_native_streaming.py,sha256=gwIqHEyX8XM4wj50n0qW6enupOzrBiaz9rhcRmI73w8,10914
29
- py3dscapture/transport/d3xx_streaming.py,sha256=JvxfnF58Q6sVT9ZlnvRBfnydweeJDHZ_OTkUmbCkKug,6699
30
- py3dscapture/transport/ftd3_backend.py,sha256=k8wceyVq8OYTILK7E8SYwOghmVd3TQCMt4W-xR5SxqQ,7795
31
- py3dscapture/transport/ftd3_pipe.py,sha256=M8CCdkHvdIMKD2NePzIWcst9cD4_guf5kZ9T-YwuhTQ,12679
32
- py3dscapture/transport/libusb_async.py,sha256=OHR1mBIrdCJP7n9RVj1WO8xjwMqC55UaKTdpT3J5BrE,4135
33
- py3dscapture/transport/libusb_backend.py,sha256=DxUOsGgPPxiJtosf_KUbf1JpPeHAJxBcybRHeW1loBs,11037
34
- ponkan_python-0.1.0.dist-info/METADATA,sha256=n7aJ3Ui81Kum0U-8e7Qegw9ysft61WkLqd2qFeYl5ZY,5746
35
- ponkan_python-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
36
- ponkan_python-0.1.0.dist-info/entry_points.txt,sha256=fX1my2fuKlmDn6T0PxrWSeXKmO5PsVpTfl7BYEqtYkc,274
37
- ponkan_python-0.1.0.dist-info/licenses/LICENSE,sha256=ikr_NtR46ZO2hvTX0LtCeb9wbRb19pCcY97Hw_6VA6c,1096
38
- ponkan_python-0.1.0.dist-info/licenses/NOTICE.md,sha256=KZPWtflkTM1GTH5e5UP7OvP7D8xYJotWUxgiePabylc,445
39
- ponkan_python-0.1.0.dist-info/RECORD,,
@@ -1,5 +0,0 @@
1
- [console_scripts]
2
- py3dscapture-capture-raw = py3dscapture.tools.capture_raw:main
3
- py3dscapture-list-devices = py3dscapture.tools.list_devices:main
4
- py3dscapture-raw-to-png = py3dscapture.tools.raw_to_png:main
5
- py3dscapture-stream-n3dsxl = py3dscapture.tools.stream_n3dsxl:main
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes