1 /* Linux driver for Philips webcam
2 USB and Video4Linux interface part.
3 (C) 1999-2004 Nemosoft Unv.
6 NOTE: this version of pwc is an unofficial (modified) release of pwc & pcwx
7 driver and thus may have bugs that are not present in the original version.
9 The decompression routines have been implemented by reverse-engineering the
10 Nemosoft binary pwcx module. Caveat emptor.
12 This program is free software; you can redistribute it and/or modify
13 it under the terms of the GNU General Public License as published by
14 the Free Software Foundation; either version 2 of the License, or
15 (at your option) any later version.
17 This program is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 GNU General Public License for more details.
22 You should have received a copy of the GNU General Public License
23 along with this program; if not, write to the Free Software
24 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
28 #include <linux/errno.h>
29 #include <linux/init.h>
31 #include <linux/module.h>
32 #include <linux/poll.h>
33 #include <linux/vmalloc.h>
38 static struct v4l2_queryctrl pwc_controls[] = {
40 .id = V4L2_CID_BRIGHTNESS,
41 .type = V4L2_CTRL_TYPE_INTEGER,
49 .id = V4L2_CID_CONTRAST,
50 .type = V4L2_CTRL_TYPE_INTEGER,
58 .id = V4L2_CID_SATURATION,
59 .type = V4L2_CTRL_TYPE_INTEGER,
68 .type = V4L2_CTRL_TYPE_INTEGER,
76 .id = V4L2_CID_RED_BALANCE,
77 .type = V4L2_CTRL_TYPE_INTEGER,
85 .id = V4L2_CID_BLUE_BALANCE,
86 .type = V4L2_CTRL_TYPE_INTEGER,
94 .id = V4L2_CID_AUTO_WHITE_BALANCE,
95 .type = V4L2_CTRL_TYPE_BOOLEAN,
96 .name = "Auto White Balance",
103 .id = V4L2_CID_EXPOSURE,
104 .type = V4L2_CTRL_TYPE_INTEGER,
105 .name = "Shutter Speed (Exposure)",
109 .default_value = 200,
112 .id = V4L2_CID_AUTOGAIN,
113 .type = V4L2_CTRL_TYPE_BOOLEAN,
114 .name = "Auto Gain Enabled",
122 .type = V4L2_CTRL_TYPE_INTEGER,
123 .name = "Gain Level",
130 .id = V4L2_CID_PRIVATE_SAVE_USER,
131 .type = V4L2_CTRL_TYPE_BUTTON,
132 .name = "Save User Settings",
139 .id = V4L2_CID_PRIVATE_RESTORE_USER,
140 .type = V4L2_CTRL_TYPE_BUTTON,
141 .name = "Restore User Settings",
148 .id = V4L2_CID_PRIVATE_RESTORE_FACTORY,
149 .type = V4L2_CTRL_TYPE_BUTTON,
150 .name = "Restore Factory Settings",
157 .id = V4L2_CID_PRIVATE_COLOUR_MODE,
158 .type = V4L2_CTRL_TYPE_BOOLEAN,
159 .name = "Colour mode",
166 .id = V4L2_CID_PRIVATE_AUTOCONTOUR,
167 .type = V4L2_CTRL_TYPE_BOOLEAN,
168 .name = "Auto contour",
175 .id = V4L2_CID_PRIVATE_CONTOUR,
176 .type = V4L2_CTRL_TYPE_INTEGER,
184 .id = V4L2_CID_PRIVATE_BACKLIGHT,
185 .type = V4L2_CTRL_TYPE_BOOLEAN,
186 .name = "Backlight compensation",
193 .id = V4L2_CID_PRIVATE_FLICKERLESS,
194 .type = V4L2_CTRL_TYPE_BOOLEAN,
195 .name = "Flickerless",
202 .id = V4L2_CID_PRIVATE_NOISE_REDUCTION,
203 .type = V4L2_CTRL_TYPE_INTEGER,
204 .name = "Noise reduction",
213 static void pwc_vidioc_fill_fmt(const struct pwc_device *pdev, struct v4l2_format *f)
215 memset(&f->fmt.pix, 0, sizeof(struct v4l2_pix_format));
216 f->fmt.pix.width = pdev->view.x;
217 f->fmt.pix.height = pdev->view.y;
218 f->fmt.pix.field = V4L2_FIELD_NONE;
219 if (pdev->pixfmt == V4L2_PIX_FMT_YUV420) {
220 f->fmt.pix.pixelformat = V4L2_PIX_FMT_YUV420;
221 f->fmt.pix.bytesperline = (f->fmt.pix.width * 3)/2;
222 f->fmt.pix.sizeimage = f->fmt.pix.height * f->fmt.pix.bytesperline;
224 /* vbandlength contains 4 lines ... */
225 f->fmt.pix.bytesperline = pdev->vbandlength/4;
226 f->fmt.pix.sizeimage = pdev->frame_size + sizeof(struct pwc_raw_frame);
227 if (DEVICE_USE_CODEC1(pdev->type))
228 f->fmt.pix.pixelformat = V4L2_PIX_FMT_PWC1;
230 f->fmt.pix.pixelformat = V4L2_PIX_FMT_PWC2;
232 PWC_DEBUG_IOCTL("pwc_vidioc_fill_fmt() "
233 "width=%d, height=%d, bytesperline=%d, sizeimage=%d, pixelformat=%c%c%c%c\n",
236 f->fmt.pix.bytesperline,
237 f->fmt.pix.sizeimage,
238 (f->fmt.pix.pixelformat)&255,
239 (f->fmt.pix.pixelformat>>8)&255,
240 (f->fmt.pix.pixelformat>>16)&255,
241 (f->fmt.pix.pixelformat>>24)&255);
244 /* ioctl(VIDIOC_TRY_FMT) */
245 static int pwc_vidioc_try_fmt(struct pwc_device *pdev, struct v4l2_format *f)
247 if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE) {
248 PWC_DEBUG_IOCTL("Bad video type must be V4L2_BUF_TYPE_VIDEO_CAPTURE\n");
252 switch (f->fmt.pix.pixelformat) {
253 case V4L2_PIX_FMT_YUV420:
255 case V4L2_PIX_FMT_PWC1:
256 if (DEVICE_USE_CODEC23(pdev->type)) {
257 PWC_DEBUG_IOCTL("codec1 is only supported for old pwc webcam\n");
261 case V4L2_PIX_FMT_PWC2:
262 if (DEVICE_USE_CODEC1(pdev->type)) {
263 PWC_DEBUG_IOCTL("codec23 is only supported for new pwc webcam\n");
268 PWC_DEBUG_IOCTL("Unsupported pixel format\n");
273 if (f->fmt.pix.width > pdev->view_max.x)
274 f->fmt.pix.width = pdev->view_max.x;
275 else if (f->fmt.pix.width < pdev->view_min.x)
276 f->fmt.pix.width = pdev->view_min.x;
278 if (f->fmt.pix.height > pdev->view_max.y)
279 f->fmt.pix.height = pdev->view_max.y;
280 else if (f->fmt.pix.height < pdev->view_min.y)
281 f->fmt.pix.height = pdev->view_min.y;
286 /* ioctl(VIDIOC_SET_FMT) */
287 static int pwc_vidioc_set_fmt(struct pwc_device *pdev, struct v4l2_format *f)
289 int ret, fps, snapshot, compression, pixelformat;
291 ret = pwc_vidioc_try_fmt(pdev, f);
295 pixelformat = f->fmt.pix.pixelformat;
296 compression = pdev->vcompression;
299 if (f->fmt.pix.priv) {
300 compression = (f->fmt.pix.priv & PWC_QLT_MASK) >> PWC_QLT_SHIFT;
301 snapshot = !!(f->fmt.pix.priv & PWC_FPS_SNAPSHOT);
302 fps = (f->fmt.pix.priv & PWC_FPS_FRMASK) >> PWC_FPS_SHIFT;
307 if (pixelformat != V4L2_PIX_FMT_YUV420 &&
308 pixelformat != V4L2_PIX_FMT_PWC1 &&
309 pixelformat != V4L2_PIX_FMT_PWC2)
315 PWC_DEBUG_IOCTL("Trying to set format to: width=%d height=%d fps=%d "
316 "compression=%d snapshot=%d format=%c%c%c%c\n",
317 f->fmt.pix.width, f->fmt.pix.height, fps,
318 compression, snapshot,
320 (pixelformat>>8)&255,
321 (pixelformat>>16)&255,
322 (pixelformat>>24)&255);
324 ret = pwc_set_video_mode(pdev,
331 PWC_DEBUG_IOCTL("pwc_set_video_mode(), return=%d\n", ret);
336 pdev->pixfmt = pixelformat;
338 pwc_vidioc_fill_fmt(pdev, f);
344 long pwc_video_do_ioctl(struct file *file, unsigned int cmd, void *arg)
346 struct video_device *vdev = video_devdata(file);
347 struct pwc_device *pdev;
348 DECLARE_WAITQUEUE(wait, current);
352 pdev = video_get_drvdata(vdev);
356 #ifdef CONFIG_USB_PWC_DEBUG
357 if (PWC_DEBUG_LEVEL_IOCTL & pwc_trace) {
358 v4l_printk_ioctl(cmd);
366 case VIDIOC_QUERYCAP:
368 struct v4l2_capability *cap = arg;
370 PWC_DEBUG_IOCTL("ioctl(VIDIOC_QUERYCAP) This application "\
371 "try to use the v4l2 layer\n");
372 strcpy(cap->driver,PWC_NAME);
373 strlcpy(cap->card, vdev->name, sizeof(cap->card));
374 usb_make_path(pdev->udev,cap->bus_info,sizeof(cap->bus_info));
375 cap->version = PWC_VERSION_CODE;
377 V4L2_CAP_VIDEO_CAPTURE |
383 case VIDIOC_ENUMINPUT:
385 struct v4l2_input *i = arg;
387 if ( i->index ) /* Only one INPUT is supported */
390 memset(i, 0, sizeof(struct v4l2_input));
391 strcpy(i->name, "usb");
398 *i = 0; /* Only one INPUT is supported */
405 if ( *i ) { /* Only one INPUT is supported */
406 PWC_DEBUG_IOCTL("Only one input source is"\
407 " supported with this webcam.\n");
414 case VIDIOC_QUERYCTRL:
416 struct v4l2_queryctrl *c = arg;
419 PWC_DEBUG_IOCTL("ioctl(VIDIOC_QUERYCTRL) query id=%d\n", c->id);
420 for (i=0; i<sizeof(pwc_controls)/sizeof(struct v4l2_queryctrl); i++) {
421 if (pwc_controls[i].id == c->id) {
422 PWC_DEBUG_IOCTL("ioctl(VIDIOC_QUERYCTRL) found\n");
423 memcpy(c,&pwc_controls[i],sizeof(struct v4l2_queryctrl));
427 PWC_DEBUG_IOCTL("ioctl(VIDIOC_QUERYCTRL) not found\n");
433 struct v4l2_control *c = arg;
438 case V4L2_CID_BRIGHTNESS:
439 c->value = pwc_get_brightness(pdev);
443 case V4L2_CID_CONTRAST:
444 c->value = pwc_get_contrast(pdev);
448 case V4L2_CID_SATURATION:
449 ret = pwc_get_saturation(pdev, &c->value);
454 c->value = pwc_get_gamma(pdev);
458 case V4L2_CID_RED_BALANCE:
459 ret = pwc_get_red_gain(pdev, &c->value);
464 case V4L2_CID_BLUE_BALANCE:
465 ret = pwc_get_blue_gain(pdev, &c->value);
470 case V4L2_CID_AUTO_WHITE_BALANCE:
471 ret = pwc_get_awb(pdev);
474 c->value = (ret == PWC_WB_MANUAL)?0:1;
477 ret = pwc_get_agc(pdev, &c->value);
482 case V4L2_CID_AUTOGAIN:
483 ret = pwc_get_agc(pdev, &c->value);
486 c->value = (c->value < 0)?1:0;
488 case V4L2_CID_EXPOSURE:
489 ret = pwc_get_shutter_speed(pdev, &c->value);
493 case V4L2_CID_PRIVATE_COLOUR_MODE:
494 ret = pwc_get_colour_mode(pdev, &c->value);
498 case V4L2_CID_PRIVATE_AUTOCONTOUR:
499 ret = pwc_get_contour(pdev, &c->value);
502 c->value=(c->value == -1?1:0);
504 case V4L2_CID_PRIVATE_CONTOUR:
505 ret = pwc_get_contour(pdev, &c->value);
510 case V4L2_CID_PRIVATE_BACKLIGHT:
511 ret = pwc_get_backlight(pdev, &c->value);
515 case V4L2_CID_PRIVATE_FLICKERLESS:
516 ret = pwc_get_flicker(pdev, &c->value);
519 c->value=(c->value?1:0);
521 case V4L2_CID_PRIVATE_NOISE_REDUCTION:
522 ret = pwc_get_dynamic_noise(pdev, &c->value);
527 case V4L2_CID_PRIVATE_SAVE_USER:
528 case V4L2_CID_PRIVATE_RESTORE_USER:
529 case V4L2_CID_PRIVATE_RESTORE_FACTORY:
536 struct v4l2_control *c = arg;
541 case V4L2_CID_BRIGHTNESS:
543 ret = pwc_set_brightness(pdev, c->value);
547 case V4L2_CID_CONTRAST:
549 ret = pwc_set_contrast(pdev, c->value);
553 case V4L2_CID_SATURATION:
554 ret = pwc_set_saturation(pdev, c->value);
560 ret = pwc_set_gamma(pdev, c->value);
564 case V4L2_CID_RED_BALANCE:
566 ret = pwc_set_red_gain(pdev, c->value);
570 case V4L2_CID_BLUE_BALANCE:
572 ret = pwc_set_blue_gain(pdev, c->value);
576 case V4L2_CID_AUTO_WHITE_BALANCE:
577 c->value = (c->value == 0)?PWC_WB_MANUAL:PWC_WB_AUTO;
578 ret = pwc_set_awb(pdev, c->value);
582 case V4L2_CID_EXPOSURE:
584 ret = pwc_set_shutter_speed(pdev, c->value?0:1, c->value);
588 case V4L2_CID_AUTOGAIN:
589 /* autogain off means nothing without a gain */
592 ret = pwc_set_agc(pdev, c->value, 0);
598 ret = pwc_set_agc(pdev, 0, c->value);
602 case V4L2_CID_PRIVATE_SAVE_USER:
603 if (pwc_save_user(pdev))
606 case V4L2_CID_PRIVATE_RESTORE_USER:
607 if (pwc_restore_user(pdev))
610 case V4L2_CID_PRIVATE_RESTORE_FACTORY:
611 if (pwc_restore_factory(pdev))
614 case V4L2_CID_PRIVATE_COLOUR_MODE:
615 ret = pwc_set_colour_mode(pdev, c->value);
619 case V4L2_CID_PRIVATE_AUTOCONTOUR:
620 c->value=(c->value == 1)?-1:0;
621 ret = pwc_set_contour(pdev, c->value);
625 case V4L2_CID_PRIVATE_CONTOUR:
627 ret = pwc_set_contour(pdev, c->value);
631 case V4L2_CID_PRIVATE_BACKLIGHT:
632 ret = pwc_set_backlight(pdev, c->value);
636 case V4L2_CID_PRIVATE_FLICKERLESS:
637 ret = pwc_set_flicker(pdev, c->value);
640 case V4L2_CID_PRIVATE_NOISE_REDUCTION:
641 ret = pwc_set_dynamic_noise(pdev, c->value);
650 case VIDIOC_ENUM_FMT:
652 struct v4l2_fmtdesc *f = arg;
655 if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
658 /* We only support two format: the raw format, and YUV */
660 memset(f,0,sizeof(struct v4l2_fmtdesc));
661 f->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
667 f->pixelformat = pdev->type<=646?V4L2_PIX_FMT_PWC1:V4L2_PIX_FMT_PWC2;
668 f->flags = V4L2_FMT_FLAG_COMPRESSED;
669 strlcpy(f->description,"Raw Philips Webcam",sizeof(f->description));
672 f->pixelformat = V4L2_PIX_FMT_YUV420;
673 strlcpy(f->description,"4:2:0, planar, Y-Cb-Cr",sizeof(f->description));
683 struct v4l2_format *f = arg;
685 PWC_DEBUG_IOCTL("ioctl(VIDIOC_G_FMT) return size %dx%d\n",pdev->image.x,pdev->image.y);
686 if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
689 pwc_vidioc_fill_fmt(pdev, f);
695 return pwc_vidioc_try_fmt(pdev, arg);
698 return pwc_vidioc_set_fmt(pdev, arg);
702 v4l2_std_id *std = arg;
703 *std = V4L2_STD_UNKNOWN;
709 v4l2_std_id *std = arg;
710 if (*std != V4L2_STD_UNKNOWN)
717 struct v4l2_standard *std = arg;
720 std->id = V4L2_STD_UNKNOWN;
721 strlcpy(std->name, "webcam", sizeof(std->name));
727 struct v4l2_requestbuffers *rb = arg;
730 PWC_DEBUG_IOCTL("ioctl(VIDIOC_REQBUFS) count=%d\n",rb->count);
731 if (rb->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
733 if (rb->memory != V4L2_MEMORY_MMAP)
736 nbuffers = rb->count;
739 else if (nbuffers > pwc_mbufs)
740 nbuffers = pwc_mbufs;
741 /* Force to use our # of buffers */
742 rb->count = pwc_mbufs;
746 case VIDIOC_QUERYBUF:
748 struct v4l2_buffer *buf = arg;
751 PWC_DEBUG_IOCTL("ioctl(VIDIOC_QUERYBUF) index=%d\n",buf->index);
752 if (buf->type != V4L2_BUF_TYPE_VIDEO_CAPTURE) {
753 PWC_DEBUG_IOCTL("ioctl(VIDIOC_QUERYBUF) Bad type\n");
756 if (buf->memory != V4L2_MEMORY_MMAP) {
757 PWC_DEBUG_IOCTL("ioctl(VIDIOC_QUERYBUF) Bad memory type\n");
761 if (index < 0 || index >= pwc_mbufs) {
762 PWC_DEBUG_IOCTL("ioctl(VIDIOC_QUERYBUF) Bad index %d\n", buf->index);
766 memset(buf, 0, sizeof(struct v4l2_buffer));
767 buf->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
769 buf->m.offset = index * pdev->len_per_image;
770 if (pdev->pixfmt != V4L2_PIX_FMT_YUV420)
771 buf->bytesused = pdev->frame_size + sizeof(struct pwc_raw_frame);
773 buf->bytesused = pdev->view.size;
774 buf->field = V4L2_FIELD_NONE;
775 buf->memory = V4L2_MEMORY_MMAP;
776 //buf->flags = V4L2_BUF_FLAG_MAPPED;
777 buf->length = pdev->len_per_image;
779 PWC_DEBUG_READ("VIDIOC_QUERYBUF: index=%d\n",buf->index);
780 PWC_DEBUG_READ("VIDIOC_QUERYBUF: m.offset=%d\n",buf->m.offset);
781 PWC_DEBUG_READ("VIDIOC_QUERYBUF: bytesused=%d\n",buf->bytesused);
788 struct v4l2_buffer *buf = arg;
790 PWC_DEBUG_IOCTL("ioctl(VIDIOC_QBUF) index=%d\n",buf->index);
791 if (buf->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
793 if (buf->memory != V4L2_MEMORY_MMAP)
795 if (buf->index >= pwc_mbufs)
798 buf->flags |= V4L2_BUF_FLAG_QUEUED;
799 buf->flags &= ~V4L2_BUF_FLAG_DONE;
806 struct v4l2_buffer *buf = arg;
809 PWC_DEBUG_IOCTL("ioctl(VIDIOC_DQBUF)\n");
811 if (buf->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
814 /* Add ourselves to the frame wait-queue.
816 FIXME: needs auditing for safety.
817 QUESTION: In what respect? I think that using the
820 add_wait_queue(&pdev->frameq, &wait);
821 while (pdev->full_frames == NULL) {
822 if (pdev->error_status) {
823 remove_wait_queue(&pdev->frameq, &wait);
824 set_current_state(TASK_RUNNING);
825 return -pdev->error_status;
828 if (signal_pending(current)) {
829 remove_wait_queue(&pdev->frameq, &wait);
830 set_current_state(TASK_RUNNING);
834 set_current_state(TASK_INTERRUPTIBLE);
836 remove_wait_queue(&pdev->frameq, &wait);
837 set_current_state(TASK_RUNNING);
839 PWC_DEBUG_IOCTL("VIDIOC_DQBUF: frame ready.\n");
840 /* Decompress data in pdev->images[pdev->fill_image] */
841 ret = pwc_handle_frame(pdev);
844 PWC_DEBUG_IOCTL("VIDIOC_DQBUF: after pwc_handle_frame\n");
846 buf->index = pdev->fill_image;
847 if (pdev->pixfmt != V4L2_PIX_FMT_YUV420)
848 buf->bytesused = pdev->frame_size + sizeof(struct pwc_raw_frame);
850 buf->bytesused = pdev->view.size;
851 buf->flags = V4L2_BUF_FLAG_MAPPED;
852 buf->field = V4L2_FIELD_NONE;
853 do_gettimeofday(&buf->timestamp);
855 buf->memory = V4L2_MEMORY_MMAP;
856 buf->m.offset = pdev->fill_image * pdev->len_per_image;
857 buf->length = pdev->len_per_image;
858 pwc_next_image(pdev);
860 PWC_DEBUG_IOCTL("VIDIOC_DQBUF: buf->index=%d\n",buf->index);
861 PWC_DEBUG_IOCTL("VIDIOC_DQBUF: buf->length=%d\n",buf->length);
862 PWC_DEBUG_IOCTL("VIDIOC_DQBUF: m.offset=%d\n",buf->m.offset);
863 PWC_DEBUG_IOCTL("VIDIOC_DQBUF: bytesused=%d\n",buf->bytesused);
864 PWC_DEBUG_IOCTL("VIDIOC_DQBUF: leaving\n");
869 case VIDIOC_STREAMON:
871 return pwc_isoc_init(pdev);
874 case VIDIOC_STREAMOFF:
876 pwc_isoc_cleanup(pdev);
880 case VIDIOC_ENUM_FRAMESIZES:
882 struct v4l2_frmsizeenum *fsize = arg;
883 unsigned int i = 0, index = fsize->index;
885 if (fsize->pixel_format == V4L2_PIX_FMT_YUV420) {
886 for (i = 0; i < PSZ_MAX; i++) {
887 if (pdev->image_mask & (1UL << i)) {
889 fsize->type = V4L2_FRMSIZE_TYPE_DISCRETE;
890 fsize->discrete.width = pwc_image_sizes[i].x;
891 fsize->discrete.height = pwc_image_sizes[i].y;
896 } else if (fsize->index == 0 &&
897 ((fsize->pixel_format == V4L2_PIX_FMT_PWC1 && DEVICE_USE_CODEC1(pdev->type)) ||
898 (fsize->pixel_format == V4L2_PIX_FMT_PWC2 && DEVICE_USE_CODEC23(pdev->type)))) {
900 fsize->type = V4L2_FRMSIZE_TYPE_DISCRETE;
901 fsize->discrete.width = pdev->abs_max.x;
902 fsize->discrete.height = pdev->abs_max.y;
908 case VIDIOC_ENUM_FRAMEINTERVALS:
910 struct v4l2_frmivalenum *fival = arg;
914 for (i = 0; i < PSZ_MAX; i++) {
915 if (pwc_image_sizes[i].x == fival->width &&
916 pwc_image_sizes[i].y == fival->height) {
922 /* TODO: Support raw format */
923 if (size < 0 || fival->pixel_format != V4L2_PIX_FMT_YUV420) {
927 i = pwc_get_fps(pdev, fival->index, size);
931 fival->type = V4L2_FRMIVAL_TYPE_DISCRETE;
932 fival->discrete.numerator = 1;
933 fival->discrete.denominator = i;
939 return pwc_ioctl(pdev, cmd, arg);
944 /* vim: set cino= formatoptions=croql cindent shiftwidth=8 tabstop=8: */