The Linux Kernel
5.11.0
  • The Linux kernel user’s and administrator’s guide
  • Kernel Build System
  • The Linux kernel firmware guide
  • Open Firmware and Device Tree
  • The Linux kernel user-space API guide
    • No New Privileges Flag
    • Seccomp BPF (SECure COMPuting with filters)
    • unshare system call
    • Speculation Control
    • OpenCAPI (Open Coherent Accelerator Processor Interface)
    • IOCTLs
    • IOMMU Userspace API
    • Linux Media Infrastructure userspace API
      • Introduction
      • Part I - Video for Linux API
        • 1. Common API Elements
        • 2. Image Formats
        • 3. Input/Output
        • 4. Interfaces
        • 5. Libv4l Userspace Library
        • 6. Changes
        • 7. Function Reference
        • 8. Common definitions for V4L2 and V4L2 subdev interfaces
        • 9. Video For Linux Two Header File
        • 10. Video Capture Example
        • 11. Video Grabber example using libv4l
        • 12. References
        • Revision and Copyright
        • Revision History
      • Part II - Digital TV API
      • Part III - Remote Controller API
      • Part IV - Media Controller API
      • Part V - Consumer Electronics Control API
      • Generic Error Codes
      • Glossary
      • GNU Free Documentation License
      • Video4Linux (V4L) driver-specific documentation
  • Working with the kernel development community
  • Development tools for the kernel
  • How to write kernel documentation
  • Kernel Hacking Guides
  • Linux Tracing Technologies
  • Kernel Maintainer Handbook
  • fault-injection
  • Kernel Livepatching
  • The Linux driver implementer’s API guide
  • Core API Documentation
  • locking
  • Accounting
  • Block
  • cdrom
  • Linux CPUFreq - CPU frequency and voltage scaling code in the Linux(TM) kernel
  • Integrated Drive Electronics (IDE)
  • Frame Buffer
  • fpga
  • Human Interface Devices (HID)
  • I2C/SMBus Subsystem
  • Industrial I/O
  • ISDN
  • InfiniBand
  • LEDs
  • NetLabel
  • Linux Networking Documentation
  • pcmcia
  • Power Management
  • TCM Virtual Device
  • timers
  • Serial Peripheral Interface (SPI)
  • 1-Wire Subsystem
  • Linux Watchdog Support
  • Linux Virtualization Support
  • The Linux Input Documentation
  • Linux Hardware Monitoring
  • Linux GPU Driver Developer’s Guide
  • Security Documentation
  • Linux Sound Subsystem Documentation
  • Linux Kernel Crypto API
  • Filesystems in the Linux kernel
  • Linux Memory Management Documentation
  • BPF Documentation
  • USB support
  • Linux PCI Bus Subsystem
  • Linux SCSI Subsystem
  • Assorted Miscellaneous Devices Documentation
  • Linux Scheduler
  • MHI
  • Assembler Annotations
  • ARM Architecture
  • ARM64 Architecture
  • IA-64 Architecture
  • m68k Architecture
  • MIPS-specific Documentation
  • Nios II Specific Documentation
  • OpenRISC Architecture
  • PA-RISC Architecture
  • powerpc
  • RISC-V architecture
  • s390 Architecture
  • SuperH Interfaces Guide
  • Sparc Architecture
  • x86-specific Documentation
  • Xtensa Architecture
  • ext4 Data Structures and Algorithms
  • Unsorted Documentation
  • Atomic Types
  • Atomic bitops
  • Memory Barriers
  • General notification mechanism
  • Translations
The Linux Kernel
  • Docs »
  • The Linux kernel user-space API guide »
  • Linux Media Infrastructure userspace API »
  • Part I - Video for Linux API »
  • 1. Common API Elements
  • View page source

1. Common API Elements¶

Programming a V4L2 device consists of these steps:

  • Opening the device
  • Changing device properties, selecting a video and audio input, video standard, picture brightness a. o.
  • Negotiating a data format
  • Negotiating an input/output method
  • The actual input/output loop
  • Closing the device

In practice most steps are optional and can be executed out of order. It depends on the V4L2 device type, you can read about the details in Interfaces. In this chapter we will discuss the basic concepts applicable to all devices.

  • 1.1. Opening and Closing Devices
  • 1.2. Querying Capabilities
  • 1.3. Application Priority
  • 1.4. Video Inputs and Outputs
  • 1.5. Audio Inputs and Outputs
  • 1.6. Tuners and Modulators
  • 1.7. Video Standards
  • 1.8. Digital Video (DV) Timings
  • 1.9. User Controls
  • 1.10. Extended Controls API
  • 1.11. Camera Control Reference
  • 1.12. Flash Control Reference
  • 1.13. Image Source Control Reference
  • 1.14. Image Process Control Reference
  • 1.15. Codec Control Reference
  • 1.16. Stateless Codec Control Reference
  • 1.17. JPEG Control Reference
  • 1.18. Digital Video Control Reference
  • 1.19. RF Tuner Control Reference
  • 1.20. FM Transmitter Control Reference
  • 1.21. FM Receiver Control Reference
  • 1.22. Detect Control Reference
  • 1.23. Guidelines for Video4Linux pixel format 4CCs
  • 1.24. Data Formats
  • 1.25. Single- and multi-planar APIs
  • 1.26. Cropping, composing and scaling – the SELECTION API
  • 1.27. Image Cropping, Insertion and Scaling – the CROP API
  • 1.28. Streaming Parameters
Next Previous

© Copyright The kernel development community

Built with Sphinx using a theme provided by Read the Docs.