v4l2_find_ne..._conditional(9)

👑 v4l2_find_ne..._conditional(9) — Kernel API Manual, but make it make sense 💅

okay so bestie, gather round, because we're talking about v4l2_find_nearest_size_conditional ✨ this is a Kernel API Manual page, and honestly? it's giving "small function, big job" energy 🎀

---

🌸 NAME 🌸

v4l2_find_nearest_size_conditional — finds the nearest size among a discrete set of resolutions, all sitting pretty inside an array of a driver specific struct, and it can conditionally exclude certain modes 🦋 (yes, "exclusion", we're being fancy)

---

✨ SYNOPSIS ✨

v4l2_find_nearest_size_conditional (array , array_size , width_field ,
       height_field , width , height , func , context );

---

💖 ARGUMENTS 💖

• array — a driver specific array of image sizes. it's the lineup, the roster, the main-character list 📋
• array_size — the length of that driver specific array of image sizes. gotta know how many we're working with, no cap 🔢
• width_field — the name of the width field in the driver specific struct 🎀
• height_field — the name of the height field in the driver specific struct 🎀 (sibling energy to width_field, we love a matching set)
• width — desired width. what you want 💭
• height — desired height. also what you want 💭
• func — ignores a mode if it returns false. it's the vibe check function, basically 🙈
• context — context for the function. gotta pass it along so it knows what's up 🫶

---

🔥 DESCRIPTION 🔥

So what does it actually do? It finds the closest resolution — the one that minimizes the width and height differences between what you requested and the supported resolutions 💫 literally just "get me as close as you can, bestie".

Important detail, do NOT skip this: the size of the width and height fields in the driver specific must equal that of u32, i.e. four bytes. four. bytes. periodt 👑

And about func — it gets called for each mode considered, and a mode is ignored if func returns false for it. so it's a filter, a bouncer, a "you're not on the list" situation 💀

Returns the best match or NULL if the length of the array is zero. yeah, empty array = nothing to give, you get NULL 😭

---

🌈 SEE ALSO 🌈

Kernel file ./include/media/v4l2-common.h, plus the whole friend group:

• v4l2_ctrl_query_fill(9)
• enum v4l2_i2c_tuner_type(9)
• v4l2_i2c_new_subdev(9)
• v4l2_i2c_new_subdev_board(9)
• v4l2_i2c_subdev_set_name(9)
• v4l2_i2c_subdev_init(9)
• v4l2_i2c_subdev_addr(9)
• v4l2_i2c_tuner_addrs(9)
• v4l2_i2c_subdev_unregister(9)
• v4l2_spi_new_subdev(9)
• v4l2_spi_subdev_init(9)
• v4l2_spi_subdev_unregister(9)
• v4l_bound_align_image(9)
• v4l2_find_nearest_size(9)
• v4l2_g_parm_cap(9)
• v4l2_s_parm_cap(9)
• enum v4l2_pixel_encoding(9)
• struct v4l2_format_info(9)
• v4l2_get_link_freq(9)
• v4l2_get_active_data_lanes(9)
• v4l2_link_freq_to_bitmap(9)
• devm_v4l2_sensor_clk_get(9)
• devm_v4l2_sensor_clk_get_legacy(9)

---

and that's the whole page, bestie, you ate that 🍓💜

cute little sign-off: this one lives in ./include/media, dated October 2026, and it's v4l2_find_ne..._conditional(9) — go forth and find your nearest size, icon 🧚✨